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PREFACE 



This publication provides customer 
engineers and other technical personnel 
with information describing the internal 
organization and logic of the level F lin- 
kage editor, version 2. It is part of an 
integrated library of IBM System/360 
Operating System Program Logic Manuals. 
Other publications that are required for an 
understanding of the linkage editor are: 



IBM System/360 Operating System : 

Introduction to Control Program Logic y 
Program Logic Manual , Form Y28-6605 

Concepts and Facilities , Form C28-6535 

Linkage Editor , Form C28-6538 

Assembler Language , Form C28-6514 

The reader should also refer to the co- 
requisite publications: 

IBM System/360 Operating System: 

Storage Estimates , Form C28-6551 

System Control Blocks , Form C28-6628 

This manual consists of seven parts: 

1 . An Introduction, which describes the 
linkage editor as a whole, including 
its relationship to the operating sys- 
tem. The major divisions of the pro- 
gram and the relationships among them 
are also described in this section. 

2. A Method of Operation section which 
provides: (a) an overview of, and an 



introduction to the logic of the lin- 
kage editor, and (b) detailed descrip- 
tions of specific operations. Opera- 
tion diagrams, included at the end of 
this section, are designed to be used 
with the text, and illustrate the flow 
of data through tables and buffers 
used during linkage editor processing. 



3. A section describing the organization 
of Linkage Editor F. Program com- 
ponents (modules, control sections, 
and routines) are described both in 
terms of their operation and their 
relation to other components. Flow- 
charts are included at the end of this 
section. 



4. A directory which helps the reader 
find named areas of code in the pro- 
gram listing, which is contained on 
microfiche cards. 

5. A section illustrating the layouts of 
tables used by linkage editor F. 
Table layouts may not be essential for 
an understanding of the basic logic of 
the program, but are essential for 
analysis of storage dumps. 

6. Diagnostic aids, including general 
register contents at entry to modules, 
and an error message — module cross 
reference table. 

7. An appendix, which includes input con- 
ventions and record formats. 

If more detailed information is 
required, the reader should refer to the 
comments and coding in the linkage editor 
program listings. 
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SECTION 1: INTRODUCTION 



This section provides general informa- 
tion describing the purpose, organization, 
and internal operation of the linkage edi- 
tor, and its relationship to the operating 
system. 

The level F linkage editor, version 2, 
(hereinafter referred to as the linkage 
editor) is available in U4K, 88K, and 128K 
design points; they differ in speed and 
table size. The 44K and 88K design points 
use different overlay structures, and the 
128K design point is not in overlay. All 
versions of the linkage editor operate in 
essentially the same manner. 



PURPOSE OF LINKAGE EDITOR 

The linkage editor is one of the proces- 
sing programs of IBM System/360 Operating 
System. It is a service program used in 
association with the language translators 
to prepare machine- language programs from 
symbolic- language programs written in FOR- 
TRAN, COBOL, report program generator, the 
assembler language, or PL/I. Linkage edi- 
tor processing is a necessary step that 
follows source program assembly or 
compilation. 

Linkage editor processing allows the 
programmer to divide his program into sev- 
eral parts, each containing one or more 
control sections. Each part may then be 
coded in the programming language best 
suited to it and may then be separately 
assembled or compiled by a language trans- 
lator (under the rules applicable to each 
language translator) . 

The primary purpose of the linkage edi- 
tor is to combine and link object modules 
(the output of the language translators) 
into a load module in which all cross 
references between control sections are 
resolved as if they had been assembled or 
compiled as one module. The load module 
produced by the linkage editor consists of 
executable machine- language code in a for- 
mat that can be loaded into main storage 
and relocated by program fetch. 

In addition to combining and linking 
object modules, the linkage editor performs 
the following functions: 

• Library Calls . Modules (such as stan- 
dard subroutines) stored in a library 
can be placed in the input to linkage 
editor, either automatically or upon 
request. If unresolved external 



references remain after all input to 
the linkage editor is processed, an 
automatic library call routine 
retrieves the modules required to 
resolve the references. 

• Program Modification . Control sections 
can be replaced, deleted, or rearranged 

(in overlay programs) during linkage 
editor processing, as directed by link- 
age editor control statements. Common 
control sections generated by the FOR- 
TRAN, PL/I, and assembler language 
translators are provided locations 
within the output load module. 

• Overlay Module Processing . Linkage 
editor prepares modules for overlay by 
assigning relative locations within the 
module to the overlay segments and by 
inserting tables to be used by the 
overlay supervisor during execution. 



Options and Error Messages , 
age editor can: 



The link- 



1. Process special options that over- 
ride automatic library calls or 
the effect of minor errors. 

2. Produce a list of linkage editor 
control statements that were 
processed. 

3. Produce coded diagnostic messages 
and a directory describing those 
diagnostic messages that were 
printed out during linkage editor 
processing. 

4. Produce a module map or cross- 
reference table of control sec- 
tions in the output load module. 



RELATIONSHIP TO THE OPERATING SYSTEM 

The linkage editor has the same rela- 
tionship to the operating system as any 
other processing program. Control is 
passed to the linkage editor in one of 
three ways: 

1 . As a job step, when the linkage editor 
is specified on an EXEC job control 
statement in the input stream. 

2. As a subprogram, via the execution of 
a CALL macro instruction (after execu- 
tion of a LOAD macro instruction) , a 
LINK macro instruction, or an XCTL 
macro instruction. 
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3. As a subtask, in multitasking systems, 
via execution of the ATTACH macro 
instruction. 



GENERAL DESCRIPTION 

Linkage editor input may consist of a 
combination of object modules , load 
modules r and linkage editor control state- 
ments. The prime function of the linkage 
editor is to combine these modules , in 
accordance with requirements stated on con- 
trol statements, into a single output load 
module that can be relocated and loaded 
into main storage by program fetch for 
execution. Output load modules are placed 
in partitioned data sets (libraries) . 



These symbolic cross-references are 
made by means of address constants . 
The linkage editor calculates the new 
address of each relocatable expression 
in a control section and determines 
the assigned origin (value) of the 
item to which it refers. 

Linkage editor processing is affected by 
specified options, operations requested on 
control statements, module attributes con- 
tained in partitioned data set directories, 
and control information contained within 
the modules themselves. The following 
paragraphs describe the relationship of 
module structure, selected options, and 
module attributes to linkage editor 
processing. 



Each module to be processed by linkage 
editor has an origin that was assigned dur- 
ing assembly, during compilation, or during 
a previous execution of the linkage editor. 
Each module in the input to linkage editor 
may contain symbolic references to control 
sections in other modules; such references 
are called external references. 



To produce an executable output load 
module, the linkage editor: 



1 • Assigns relative main storage 

addresses to the control sections to 
be included in the output module. 
Since each input module has an origin 
that was assigned independently by a 
language translator, the order of the 
addresses in the input is unpredict- 
able. (Two input modules, for 
example, may have the same origin.) 
Linkage editor assigns an origin to 
the first control section and then 
assigns addresses, relative to this 
origin, to all other control sections 
in the output. 1 Each item in a control 
section is relocated the same number 
of bytes as the control section 
origin. 



2. Resolves external references in the 
input modules. Cross references 
between control sections in different 
modules are symbolic, and must be 
resolved (translated into relocatable 
machine addresses) , relative to the 
contiguous main storage addresses 
assigned to the output load module. 



1 If the program is in overlay, an origin is 
assigned to the first control section in 
each segment. Within each segment, con- 
tiguous addresses are assigned relative to 
the segment origin. 



MODULE STRUCTURE 

Object modules and load modules have the 
same basic logical structure (see Figure 
1) . Each consists of: 

• Control dictionaries, containing the 
information necessary to resolve sym- 
bolic cross references between control 
sections of different modules, and to 
relocate address constants. 

• Text, containing the instructions and 
data of the program. 

• An end of module (EOM) indicator (END 
statement in object modules; EOM indi- 
cation in load modules) . 



Each language translator usually pro- 
duces two kinds of control dictionaries: 
an external symbol dictionary (ESD) and a 
relocation dictionary (RLD) . An object 
module always contains an ESD; a load 
module contains an ESD, unless it is marked 
with the "not editable" attribute. Object 
and load modules usually contain an RLD 
(unless there are no relocatable address 
constants in the module) . Control dic- 
tionary entries are generated when external 
symbols, address constants, or control sec- 
tions are processed by a language 
translator. 
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External Symbol Dictionary 

The external symbol dictionary contains 
entries for all external symbols defined or 
referred to within a module. (An external 
symbol is one that is defined in one module 
and can be referred to in another.) Each 
entry identifies a symbol, or a symbol 
reference, and gives its location, if any, 
within the module. When combining input 
modules, linkage editor resolves references 
between different input modules by matching 
the referenced symbols to defined symbols; 
it does this by searching for the external 
symbol definitions in each input module's 
ESD. There is an ESD entry for each named 
control section and each named common area. 
The ESD also contains entries that identify 
unnamed control sections and unnamed common 
areas. 



Relocation Dictionary 

The relocation dictionary (RLD) lists 
all relocatable address constants that must 
be modified when the linkage editor pro- 
duces an output load module. The linkage 
editor uses the RLD whenever it processes a 



module. The RLD is also used to adjust the 
value of address constants after program 
fetch reads an output load module from a 
library and loads it into main storage for 
execution. The RLD contains at least one 
entry for every relocatable address con- 
stant in a module. An RLD entry identifies 
an address constant by indicating both its 
location within a control section and the 
external symbol (in the ESD) whose value 
must be used to compute the value of the 
address constant. 



Composite Dictionaries 

An output load module is composed of all 
input object modules and input load modules 
processed by the linkage editor (except 
those that are replaced or deleted) . The 
control dictionaries of an output module 
are therefore a composite of all the con- 
trol dictionaries in the linkage editor 
input. The control dictionaries of a load 
module are called the composite ESD (CESD) 
and the RLD. 

Figure 2 shows how the control dic- 
tionaries of two input modules are combined 
into composite dictionaries by the linkage 
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editor. The control dictionaries and their 
associated text are interrelated through a 
system of line numbers and pointers. 
Within an input module r each ESD item on 
which an address constant may depend has a 
line number (ESD identifier r or ESD ID) ; 
the line number indicates the position of 
the item r relative to the other ESD items 
associated with the text. i Every item of 
text in an object or load module has asso- 
ciated control information that describes 
it. This control information includes the 
ESD ID of the ESD item for the control sec- 
tion that contains the text. (In Figure 2, 
the ESD ID of the text item that contains X 
and Y points to line 1 of the ESD for input 
module 1 . The ESD ID of the text item con- 
taining Z points to line 1 of the ESD for 
input module 2.) 



Each RLD item must point to two ESD 
items : 



The ESD item for the symbol on which 
the address constant depends. This is 
referred to by the RLD relocation 
pointer (R pointer) . 



2. The ESD item for the control section 
that contains the address constant. 
This is referred to by the RLD posi- 
tion pointer (P pointer) . 



In input module 1 , X and Y are address 
constants in the same control section 
(CSECT A) . X refers to a symbol in CSECT 
A; therefore, both pointers of its asso- 
ciated RLD item refer to the ESD entry for 
CSECT A (line 1) . The value field of Y 
refers to a symbol in a different control 
section (CSECT C) ; therefore , the R pointer 
of its associated RLD points to the ESD 
entry for the external reference (line 2) , 
whereas the P pointer refers to the ESD 
entry for its control section (line 1) . 



SELECTED OPTIONS 



Linkage editor processing also depends 
on selected options. Figure 1 shows a 
simple case in which a single object 
module , containing only one control sec- 
tion , is processed by the linkage editor 
for block loading. 



Figure 3 shows the processing of an 
object module and a load module r each con- 
taining several control sections. In this 
example, test translator macro instructions 
were included in an assembler language 
source program and test symbol (SYM) rec- 
ords were produced by the assembler lan- 
guage translator. The TEST and overlay 
options were specified on the execute 
(EXEC) statement and overlay control state- 
ments were included in the input to linkage 
editor. With these options, the output 
load module produced by the linkage editor 
contains: 



SYM records to be used by the test 
translator . (If the TFST option is not 
specified on the EXEC statement, SYM 
records in input are not included in 
the output load module.) These records 
contain blocked SYM and ESD statements 
created during a previous execution of 
linkage editor. SYM records in load 
modules are passed through the linkage 
editor unmodified to the output device. 



A composite ESD . CESD records contain 
the ESD items for the module. There is 
a maximum of 15 ESD items per record on 
the output device. The first eight 
bytes of the CESD record contain con- 
trol information pertaining to the ESD 
items in the record. This information 
consists of the ESD ID of the first ESD 
item and the number of bytes of ESD 
items in the record. 



When the linkage editor combines the 
input modules, it must maintain this system 
of pointers by renumbering the ESD items to 
reflect their relative positions in the 
CESD of the output module. It must also 
update the RLD pointers and control infor- 
mation for the text so that they refer to 
the renumbered CESD items; the resulting 
CESD and RLD items are shown in Figure 2. 



1 In an object module, one type of ESD item 
(LD) may not have associated text or 

address constants that depend on it. 
(Refer to "ESD Processing.") Such ESD 

items are excluded from the numbering 

system. 



• A control record, or a composite 

control/RLD record, preceding each text 
record . The RLD portion, if present, 
contains the RLD items used to relocate 
the previous text. 2 The control portion 
may contain: 



An end of segment (EOS) indica- 
tion, if the following text record 



2 If there is a large number of RLD items 
for the previous text, there may be sever- 
al RLD records preceding the next text 
record. The last of these is a control/ 
RLD record. 
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is the last: text record of an 
overlay segment. 3 

2. An end of module (EOM) indication, 
if the following text record is 
the last text record of the 
module. 3 

3. The number of bytes of RLD infor- 
mation that follow, if it is a 
composite control/RLD record. 

4. The number of bytes of control 
information. 

The control portion also contains the 
IDs and lengths (in bytes) of all the 
control sections in the following text, 
to a maximum of 60 , and a channel com- 
mand word (CCW) . The channel command 
word contains the address assigned by 
the linkage editor to the first byte of 
that record, plus the total length of 
the record. This information is used 
by program fetch to read the following 
text. 

Note : The control portion contains as 
many IDs and lengths as there are con- 
trol sections in the following text 
record. 



• SYM records. 

• A composite ESD. 

• A scatter/translation record used by 
program fetch to compute the relocated 
addresses required for scatter loading 
the module into the main storage. The 
record contains a scatter table and a 
translation table . The scatter table 
is a list of control section addresses; 
the translation table correlates the 
CESD entry for each control section 
with the address indicated in the 
scatter table. (When a load module in 
scatter format is processed again by 
the linkage editor, this information is 
ignored.) 

• Text for each control section, preceded 
by a control/RLD record describing it. 

(Any RLDs pertaining to a text record 
are contained in the control/RLD record 
that follows it.) 

• An EOM indication that marks the end of 
the module. 



The Appendix (Section 7) contains the 
format of each record type. 



• Text for each control section . Text 
records contain the instructions and 
data for the module. In overlay, the 
linkage editor produces two special 
types of text records, the segment 
table (SEGTAB) and entry table (ENTAB) . 
The SEGTAB, located in the root seg- 
ment, is used by the overlay supervisor 
to keep track of the relationship of 
segments during execution. The ENTAB 
is a separate control section that may 
be created by the linkage editor for 
each overlay segment. An ENTAB is used 
by the overlay supervisor to determine 
the segment to be loaded when a segment 
not in the path is referred to. 



MODULE ATTRIBUTES 



When the linkage editor generates a load 
module in a library (partitioned data set) 
it places an entry for the module in the 
PDS directory. This entry contains "attri- 
butes" describing the structure, content, 
and logical format of the load module. The 
control program uses these attributes to 
determine how a module is to be loaded, 
what it contains, if it is executable, 
whether it is executable more than once 
without reloading, and if it can be 
executed by concurrent tasks. 



• A note list . The note list gives the 
location of each overlay segment in the 
output module library. 



Figure 4 shows the module structure when 
the scatter loading and test options are 
requested. With these options, the output 
load module contains: 



Some module attributes can be specified 
by the programmer; others are specified by 
the linkage editor as a result of informa- 
tion gathered during processing. In the 
following list, attributes marked with an 
asterisk cannot be specified by the 
programmer: 



3 If there are no RLD items for the last 
text record, the control record that pre- 
cedes the text contains the EOS or EOM 
indication. If there are RLD items, the 
EOS or EOM follows the text record. (See 
Figure 3.) 



• Reenterable . A reenterable module can 
be executed by more than one task at a 
time and cannot be modified by itself 
or by any other module during execu- 
tion; i.e., a task may begin executing 
a reenterable module before a previous 
task has finished executing it. 
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• Refreshable , A refreshable module can- 
not be modified by itself or by any 
other module during execution; i.e., a 
refreshable module can be replaced by a 
new copy during execution by a recovery 
management routine without changing 
either the sequence or results of pro- 
cessing. (For details on recovery 
management, refer to the publication 
IBM System/360 Operating System , Con- 
cepts and Facilities , Form C28-6535. 

• Serially reusable . A serially reusable 
module will be executed by only one 
task at a time, and it will either 
initialize itself and/or it will 
restore any instructions or any data in 
the module that it alters during its 
execution. 

• Overlay format . A load module struc- 
tured for overlay includes a segment 
table (SEGTAB) to enable the overlay 
supervisor to load the proper segments, 
and at least one ENTAB to assist in 
passing control from one segment to 
another. If a load module has the 
overlay format attribute, the reenter- 
able, reusable, and scatter attributes 
cannot be present. 

• Test . If this module is an assembler 
language program and testing by the 
test translator is desired, this attri- 
bute can be specified. Test will cause 
SYM records to be written. If the TEST 
attribute is specified, the module can- 
not be reenterable or serially 
reusable . 

• Only loadable . This attribute indi- 
cates that the control program may load 
this module only via the LOAD macro 
instruction. 

• Scatter format . A load module in 
scatter format is suitable for block or 
scatter loading. The scatter- 
translation table and the relocation 
dictionary maintain logical linkage 
between scattered control sections when 
program fetch loads them into main 
storage . 

• *Block format . If neither the overlay 
nor scatter attributes are specified, 
it is implied that the module can only 
be block loaded. The control program 
will load the module only if enough 
contiguous main storage space is avail- 
able for the entire module. 

• * Executable . This attribute indicates 
that linkage editor did not find any 
errors that would prevent successful 
execution. If this attribute is not 
present the control program will not 
load the module. 



• *Module contains one text record and no 
relocation dictionary records . This 
attribute indicates that the control 
program does not have to allocate main 
storage for relocation dictionary items 
when loading the module. It also indi- 
cates that the first text record is the 
last one; there is no control record 
following it. The entire module can be 
read by program fetch in a single read 
operation. 

• Downward compatible . Indicates that 
the module can be processed by either 
the level E or F linkage editor. The 
downward compatible option is assumed 
by the level E linkage editor. Modules 
processed by the level F linkage editor 
that are not marked "downward compat- 
ible" cannot be processed by the level 
E linkage editor. 

• *Linkaqe editor assigned origin of 
first text record is zero . If this 
attribute is present, the first byte of 
instruction or data in the first text 
record is assigned to location zero. 

• *Entry point assigned by linkage editor 
is zero . Indicates that the entry 
point is at the first byte of the 
module. 

• *No relocation dictionary items pre- 
sent . Indicates to, the control program 
that no allocation of main storage is 
necessary to receive relocation dic- 
tionary items when program fetch loads 
them into main storage. 

• Not editable . Indicates that the load 
module cannot be accepted by the link- 
age editor for subsequent processing. 

(For example, the programmer may drop 
the CESD from an output load module in 
order to conserve space on the library; 
such a load module cannot be repro- 
cessed by linkage editor.) 

• Symbol statements present . If a module 
produced by the assembler language 
translator is to be tested by the test 
translator, it may contain a testing 
symbol dictionary. In a load module, 
this dictionary contains the informa- 
tion from the symbol statement images 
that were input to linkage editor. 



INPUT/OUTPUT FLOW 

Four data sets must be specified for 
linkage editor processing; their ddnames 
and functions are: 

• SYSLIN . This is the "primary input 
data set," containing object modules 
and control statements. All input from 
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SYSLIN must be in 8 0- column card image 
format. 1 The SYSLIN source may be a 
card reader r magnetic tape r a direct 
access device r or a concatenation of 
data sets from different types of input 
devices. 2 

• SYSPRINT . This is the "diagnostic out- 
put data set." Diagnostic messages , 
the module map, and the cross-reference 
table are written on SYSPRINT. (In the 
Sequential Scheduling System, the 
SYSPRINT device is normally a printer 
or magnetic tape.) 

• SYSUT1 . This is the "intermediate data 
set." Linkage editor uses this data 
set for temporary storage of text and 
RLD items being processed. SYSUT1 must 
be on a direct access volume. 

Note : SYSUT1 is only opened when two- 
pass processing is in effect. 

• SYSLMOD . this is the "output module 
data set." It is a partitioned data 
set on a direct access volume. SYSLMOD 
contains load modules; their attributes 
are described in the user's portion of 
the directory entry for the member. 

An additional data set, SYSLIB, is used 
by linkage editor if there are any automa- 
tic library calls to be processed. SYSLIB 
can be defined only as a partitioned data 
set. The members of SYSLIB can be either 
load modules or object modules (but object 
and load modules cannot be contained in the 
same PDS) . When SYSLIB is opened, the 
linkage editor determines whether the PDS 
contains object or load modules by checking 
the format in the data control block (DCB) . 
If the PDS contains object modules, the 
record format (RECFM) field of the DCB 
indicates "fixed (F) format;" if it con- 
tains load modules, the DCB indicates 
"unknown (U) format." (Load module records 
are of variable length.) If SYSLIB con- 
tains object modules, the linkage editor 
ignores the user's portions of the PDS 
directory entries for the object modules. 

Other data sets may be read by linkage 
editor when it processes INCLUDE or LIBRARY 
statements specifying ddnames. Data sets 
read into main storage with INCLUDE state- 
ments may be either sequential or parti- 
tioned. SYSLIB and data sets specified in 
LIBRARY statements for use by automatic 
library call must be partitioned. 

The attributes for the "execute linkage 
editor" job step are the attributes speci- 



fied on the EXEC statement. These attri- 
butes may be modified if a load module hav- 
ing different attributes is processed. 



Figure 5 shows the input/output flow. 
During the initial processing, SYSLIN, 
SYSPRINT, SYSUT1, and SYSLMOD are opened. 
During input processing, the primary input 
is read from SYSLIN. If an INCLUDE state- 
ment is read in the primary input, the data 
set whose ddname is specified on the state- 
ment is opened, and is processed. At the 
end of all SYSLIN input, SYSLIB and any 
other data sets whose ddnames are specified 
on LIBRARY statements are processed through 
automatic library calls. 



SYSLIN 



SYSPRINT 




Final 
Processing 



11 The card images may be blocked. 
2 A concatenation of data sets cannot con- 
tain both object and load modules. 



Figure 5. Input/Output Flow 



If the TEST option has been selected, 
SYM records are written during input pro- 
cessing; text and RLD items are written 
sequentially on SYSUT1, except during 
single pass processing. The location of 
each text record on SYSUT1 is entered in a 
text note list . The location of each RLD 
record on SYSUT1 is entered in an RLD note 
list . If either note list overflows, it is 
written out on SYSUT1; either note list may 
overflow three times. 
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In intermediate processing, the CESD is 
written on SYSLMOD (unless the not editable 
attribute is indicated) . If a scatter 
table, translation table, or SEGTAB is 
required, it is also written on SYSLMOD. 
The note list for the text and RLD items on 
SYSUT1 are read into main storage. If a 
module map was required, the CESD is used 
in producing the map. If a cross-reference 
table was requested and all RLDs are in 
storage, the table is produced during 
intermediate processing. 



During second pass processing, text and 
RLD records are read into main storage from 
SYSUT1 in the order of assigned addresses 
within each segment (using the note lists 
to find the records) and are written out on 
SYSLMOD. 



In final processing, the member name and 
any alias names are entered into the PDS 
directory entry of the output load module, 
via the STOW macro instruction. If any 
coded diagnostic messages were written on 
SYSPRINT during linkage editor processing, 
a diagnostic message directory containing 
error message text is written out on 



SYSPRINT. If a cross-reference table was 
requested and was not produced during 
intermediate processing, SYSLMOD is opened 
for input, RLDs are read, and the cross- 
reference table is produced. At the end of 
final processing, SYSLMOD is closed (if it 
was opened for input) . All other data sets 
are then closed and control is returned to 
the calling program, unless the SYSLIN 
input during input processing was ter- 
minated by a NAME statement. If a NAME 
statement terminated the primary input, and 
it is not followed by end-of-file, control 
is returned to initial processing and 
SYSLMOD is opened for output, if it had 
been closed during final processing. 

When a NAME statement is used to produce 
multiple load modules in a single execution 
of linkage editor, SYSLIN, SYSPRINT , and 
SYSUT1 remain open for the entire execu- 
tion. (A pointer in the DCB for SYSUT1 is 
repositioned to the beginning of extent of 
SYSUT1 after each load module is produced.) 
If neither a module map nor a cross- 
reference table is requested , or if a 
cross-reference table is requested and all 
RLDs are in core, SYSLMOD remains open for 
output for the entire linkage editor 
execution. 
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SECTION 2: METHOD OF OPERATION 



This section contains an introduction to 
the logic of the linkage editor, which 
emphasizes the flow of primary data and 
control information through tables and 
buffers, and detailed functional descrip- 
tions of its phases. 



LOGIC OF THE LINKAGE EDITOR 

The linkage editor can be functionally 
divided into five phases: 

• Initialization 

• Input processing 

• Intermediate processing, including 
address assignment and intermediate 
output 

• Second pass processing 

• Final processing 

Operation diagrams (see Figures 6-10, 
16-19, 22, and 26) at the end of this sec- 
tion illustrate the functional operation of 
the linkage editor. The shaded areas of 
the diagrams correspond to operations 
described in the text. 

Initialization 

When the linkage editor receives control 
from the job scheduler or a calling pro- 
gram, it performs initialization functions 
in preparation for all subsequent proces- 
sing. (See Diagram A1) . The operations 
included in initial processing (area A) 
are: 

• Initialize DCBs and open data sets to 
be used during linkage editor 
processing. 

• Allocate storage for all tables, buff- 
ers, and work areas to be used by link- 
age editor processing. 

• Build the all purpose table (APT) and 
enter addresses and descriptions of all 
other tables and buffers into it. 

• Analyze the attributes and options 
passed by the calling program (speci- 
fied by the programmer) and save them 
in the all purpose table. 

When all initialization functions are 
completed, the linkage editor is ready to 
accept input. 



Input Processing 

All linkage editor input is processed 
initially during the first pass. (See Dia- 
gram A1.) Object modules from SYSLIN (pri- 
mary input data set) are read into the 
SYSLIN buffer (area B) . Object modules 
from SYSLIB or a specified user's library 
(secondary input data sets) are read into 
the object module buffer (area C) . Text 
records in load modules from SYSLIB or a 
user's library are read into the input text 
buffer (area F) ; all other load module 
records are read into the first pass RLD 
buffer (area D) . The various records which 
constitute these modules are processed as 
follows. 

Control Statements : These records, which 
may precede or follow object modules, con- 
tain information which is later used in 
symbol resolution and which specifies 
libraries containing secondary input. 
Depending on the type of control statement, 
entries are made in either the all purpose 
table (APT) or the composite external sym- 
bol dictionary (CESD) . 

ESP Records : These records from object 
modules, and CESD records from load 
modules, describe symbols that have been 
defined for external use. Entries for the 
symbols are made in the CESD (area E) . 
Entries are made in the renumbering table 
to allow the translation of the input ESD 
indentifiers (IDs) into new CESD IDs. 
Entries are made in the delink table for 
symbols that are to be deleted or replaced. 

TXT Records : These records, containing the 
instructions and data of the program, are 
moved from the SYSLIN buffer and object 
module buffer to the input text buffer 
(text records from load modules are read 
directly into the input text buffer) (area 
F) . They are arranged in the proper 
sequence and recorded in the text I/O table 
and the text note list . When the input 
text buffer is filled , its contents are 
written onto SYSUT1; if it does not become 
filled, text records are retained in the 
buffer, and "single- pass" processing is in 
effect. Text note list entries contain the 
location of text records (SYSUT1 address or 
buffer address) and other descriptive 
information. Text I/O table entries con- 
tain information identifying text records 
by ESD ID. 

RLD Records : These records, to be used 
later in relocating address constants, are 
moved from the SYSLIN buffer and object 
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module buffer to the RLD buffer (area G) . 
The relocation and position pointers (R and 
P pointers) are updated r using control 
information from the renumbering table and 
the delink table. RLD items are examined 
and marked for future processing. If V- 
type (branch- type) address constants are 
found in overlay programs r entries are made 
in the calls list for use during intermedi- 
ate processing. When the RLD buffer is 
full r RLD records are written onto SYSUT 1, 
and control information identifying RLD 
records by size (byte count) , P pointer, 
and location on SYSUT1 is entered into the 
RLD note list . If the RLD buffer does not 
become filled, RLD records are retained in 
the buffer and "single- pass" processing is 
in effect. 

SYM Records : These records , which are not 
involved in linkage editor processing, are 
gathered in the RLD buffer and are written 
directly onto SYSLMOD if the TEST option 
has been specified. If TEST has not been 
specified, SYM records are ignored. 

When all input records have been pro- 
cessed (all external symbols have been 
entered into the CESD) control is passed to 
intermediate processing. 

Intermediate Processing 

The operations included in intermediate 
processing (see Diagram A2) have two pri- 
mary objectives: to assign relative 
storage addresses to symbols in the CESD, 
and to write some of the records to be 
included in the output load module onto the 
SYSLMOD data set. MAP and XREF options may 
also be produced during intermediate 
processing. 

Address Assignment : Entries which require 
no further processing are deleted from the 
CESD; all other CESD symbols are assigned 
temporary linked addresses. Relocation 
constants are determined for all control 
sections, and the relocation constant 
table (RCT) is built (area A) . 

For all programs in overlay, additional 
processing is required. The calls list is 
used to determine ENTAB entries to be 
placed in the CESD, and the downward calls 
list is built (area F) . The segment length 
table (SEGLGTH) is built (area B) , and seg- 
ment relocation constants are computed. 
Temporary linked addresses in the CESD and 
entries in the relocation constant table 
are adjusted for overlay by adding to them 
the segment relocation constants (area B) . 

Temporary linked addresses and reloca- 
tion constants are combined to determine 
final linked addresses for symbols, and the 
results are placed in the CESD. The alias 
table is built from alias symbols in the 



CESD. At this point CESD processing is 
complete . 

MAP/XREF Processing : If the MAP option has 
been specified, a module map , containing 
sorted CESD items, is built and written on 
SYSPRINT. If the XREF option has been spe- 
cified and all RLDs are in storage, a 
cross-reference table is built from RLDs 
(in the RLD buffer) and written on 
SYSPRINT. If all RLDs are not in storage, 
the cross-reference table is built during 
final processing. 

Intermediate Output : The principal func- 
tion of this section of intermediate pro- 
cessing is to write the CESD onto the out- 
put load module data set (SYSLMOD) . The 
half ESP (HESD) , containing control infor- 
mation from CESD entries, is built (area C) 
and held in main storage for use during 
second pass processing. The text I/O table 
(area E) is scanned to determine the ID of 
the last control section containing text in 
the program (or in each segment of an over- 
lay program) ; this information is placed in 
the high ID table (HIID) (area E) , and 
noted in the HESD for use during second 
pass processing. 

For a program in overlay, the segment 
table (SEGTAB) , which defines the relation- 
ships among segments, is built and written 
(with a control record) onto SYSLMOD (area 
D) . 

For a program that is to be scatter 
loaded, a scatter table and a translation 
table are built from information in the 
CESD, and scatter/translation records are 
written onto SYSLMOD (area G) . 

Module IEWLMOUT is the Intermediate Out- 
put Processor. 

Second Pass Processing 

The objectives of second pass processing 
(see Diagram A3) are relocating address 
constants in the text and writing onto the 
SYSLMOD data set the remaining records that 
constitute the output load module. 

Text records are read from SYSUT 1 
(intermediate data set) into the second 
pass text buffer (area A) , using the text 
I/O table and the text note list to locate 
the records on SYSUT 1. The text I/O table 
is also used to determine the order in 
which text records are to be processed. 
RLD records associated with the text being 
processed are read into the second pass RLD 
input buffer , using the RLD notelist to 
locate the required records (area B) . 

Single-Pass Processing : If the linkage 
editor did not write text or RLD records 
onto SYSUT 1, single-pass processing is in 
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effect for these records. The records are 
accessed directly in the input text buffer 
and the RLD buffer, which are physically 
the same storage areas as the second pass 
text buffer and the second pass RLD input 
buffer. If text records or RLD records 
were written onto SYSUT1, they are read 
back into the same locations. 

Relocation : Address constants described by 
RLD items are moved from the second pass 
text buffer to a work area, where reloca- 
tion is performed (area C) . The manner in 
which each address constant is relocated 
depends on whether it is a V-type (branch 
type) or an A- type (non- branch type) 
address constant, or a pseudo register 
(type 1 or type 2) . 

A V-type address constant can refer to a 
named location in some other control sec- 
tion (branch type address constant) . The 
value field of such a V-type address con- 
stant always contains a zero because the 
address was not known at compilation time. 
During second pass processing, the linkage 
editor address (absolute relocation factor) 
that was assigned to the symbol and saved 
in the HESD is inserted into the value 
field. This is called absolute relocation . 
If the V-type address constant is in an 
overlay program, the address of an ENTAB 
entry for the symbol and the segment number 
of the current text is inserted in the 
value field. (ENTABs are created in the 
second pass RLD buffer from information in 
the HESD and the entry list , which contains 
an entry for each V-type address constant 
in the path of a referred-to symbol (area 
E) .) 

The value field of an A-type address 
constant that refers to a named location in 
tne same input module (non- branch type 
address constant) contains an address 
assigned by the language translator. Dur- 
ing second pass processing, this address is 
modified by adding or subtracting the rela- 
tive relocation factor that was determined 
for the symbol referred to by the address 
constant. Relative relocation factors are 
saved in the relocation constant table. 
This process is called relative relocation . 

When each address constant is relocated, 
it is placed back in the text, and the 
address field of the associated RLD item is 
updated (area D) . The RLD item is then 
moved to the second pass RLD output buffer . 
When all address constants in the text 
buffer are relocated, the text is written 
onto SYSLMOD, followed by the associated 
RLD items (area F) . A control record per- 
taining to the next text record is written 
onto SYSLMOD following the RLD records. If 
the output load module is structured for 
overlays a TTR list , containing the address 
of the first control record of each segment 



(for the first segment the list contains 
the address of the first text record) is 
also created and retained in main storage. 

Second pass processing continues until 
all segments in the output module are pro- 
cessed. The last control record contains 
end of module indicators. Control is then 
passed to final processing. 

Final Processing 

The objectives of final processing (see 
Diagram A4) include writing remaining out- 
put to SYSLMOD, producing certain optional 
output, and "cleanup" functions. 

The partitioned data set directory for 
SYSLMOD is completed, including modifica- 
tions for ALIAS symbols (found in the ALIAS 
table ) , and a STOW macro is issued (area 
B) . The TTR list, containing the address 
of the first text record in each segment, 
is written onto SYSLMOD for overlay pro- 
grams (area A) . 

The error logging map , produced as 
errors are encountered throughout linkage 
editor processing, is scanned and an error 
diagnostic directory is built and written 
on SYSPRINT, (area C) . Main storage allo- 
cated to linkage editor is released. 

If the XREF option is specified, and was 
not processed during intermediate proces- 
sing, RLD records are read from SYSLMOD, 
and a cross-reference table is built and 
written on SYSPRINT, (area D) . 

At the completion of linkage editor pro- 
cessing, control is returned to the calling 
program. 



INITIALIZATION (IEWLMINT) 

When the linkage editor receives control 
from the job scheduler, or from another 
program via a CALL (after execution of 
LOAD, LINK, XCTL, or ATTACH macro instruc- 
tion) , control information may be passed to 
it. 1 This information includes the attri- 
butes and options that control linkage edi- 
tor processing. When control is passed to 
the linkage editor from the job scheduler, 
the passed control information is the 
information contained in the operand field 
of the EXEC statement. The control infor- 
mation is interpreted, checked for validi- 
ty, and saved for later use in linkage edi- 
tor processing. 



i The method of passing information to the 
linkage editor is described in the System 
Reference Library publication IBM System/ 
360 Operating System; Linkage Editor . 
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A program that passes control to the 
linkage editor may provide a substitute 
list of ddnames to be used in place of the 
standard names, and a name that is to be 
assigned to the output load module in the 
PDS directory. 

Initialization functions performed by 
the linkage editor include: 

• Building an all purpose table, which 
contains descriptions of other tables 
used by the linkage editor, and con- 
tains decision indicators that control 
linkage editor operation. The APT 
remains in main storage throughout the 
linkage editing process and is the 
major communication area among internal 
functions . 

• Opening all data sets used by the link- 
age editor, except SYSLIB and SYSUT1, 
after the standard ddnames (or passed 
ddnames) have been entered into the 
data control blocks of the data sets. 

(The SYSLIB DCB is used for automatic 
library calls or INCLUDE statements; it 
is opened during input processing only 
if there are any automatic calls or 
INCLUDE statements specifying it. The 
SYSUT1 DCB is opened only when needed.) 

• Setting an "unlike attributes" indica- 
tor in the SYSLIN DCB. This indicates 
to the open routine that SYSLIN may be 
a concatenation of data sets stored on 
different devices. 

• Scanning and analyzing the control 
information that was previously passed 
in a list to linkage editor. The pro- 
cessing options requested by the user 
and the attributes to be assigned to 
the output load module are compared 
against an option table and noted in 
the all purpose table. When mutually 
exclusive attributes are specified for 
a load module, the linkage editor 
ignores the incompatible attribute 

(refer to Table 1) . If the SIZE option 
is specified, the associated value is 
placed in the all purpose table. If 
the SIZE option is not specified, the 
default values chosen at system genera- 
tion time are used. 

• Requesting main storage space for 
internal tables, buffers, and work 
areas. The allocation processor issues 
a request for a minimum requirement of 
main storage space. The minimum value 
depends on whether or not the module 
being processed is structured for over- 
lay; it includes an amount to be used 
by data management functions. If suf- 
ficient main storage space is avail- 
able, the supervisor returns control to 
the allocation processor and the space 



exceeding the minimum requirement is 
divided among the tables and buffers. 
If sufficient main storage space is not 
available, the control program will not 
return control to the linkage editor; 
instead, a system ABEND will occur. 

Table 1 . Incompatible Module Attributes 




Note : An X indicates incompatible attri- 
butes; the attribute that appears lower in 
the list is ignored. For example , to check 
the compatibility of XREF and NE, follow 
the XREF column down and the NE row across 
until they intersect. Since an X appears 
where they intersect, they are incompatible 
attributes. NE is ignored. 

Main Storage Allocation 

To obtain the required main storage 
space, the allocation processor: 

1. Issues the GETMAIN macro instruction, 
and if sufficient main storage space 
is available, assigns storage for the 
maximum buffer lengths to each of the 
object module buffers, SYSLIN buffers, 
and SYSPRINT buffers. If sufficient 
space for maximum buffer lengths is 
not available, intermediate buffer 
lengths are assigned. If sufficient 
space for intermediate lengths is not 
available, the minimum buffer lengths 
are assigned. 

2. Assigns main storage to the RLD buffer 
and the text buffer. The text buffer 
area is referred to as the input text 
buffer during input and intermediate 
processing, and as the second pass 
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text buffer during second pass proces- 
sing. The text buffer will be 
assigned the minimum length (6K bytes) 
unless additional space was requested 
via the SIZE parameter , in which case 
the text buffer will be expanded , as 
specif ied, up to a maximum of 100K 
bytes . 

Note ; All space allocated for buffers 
is released only at the completion of 
linkage editor processing. 

Determines the excess of main storage 
space allocated by the supervisor. 

Divides the total excess by the total 
weight factor . A weight factor is a 
ratio based on the individual main 
storage requirements of linkage editor 
tables that are not fixed in size. 
(Fixed tables have weight factors of 
zero.) The total weight factor 
depends on whether or not the module 
is structured for overlay. 

Multiplies the quotient obtained in 
step 6 (rounded to the nearest lower 
integer) by the weight factor for each 
table and adds the result to the mini- 
mum requirement for the table. This 
is done for all tables and buffers. 

Divides the total byte count for each 
table by the number of bytes per 
entry , and saves the result in the all 
purpose table. 

Computes the addresses for the tables 
and places them in the all purpose 
table. 

Releases excess main storage space , 
saving the last address used. 



When the required main storage space has 
been allocated, tables are initialized to 
zero, and the linkage editor is ready to 
accept input. 



INPUT PROCESSING (IEWLMINP) 

The operations performed during input 
processing depend on the nature of the 
input; special processing is required for 
each input record type. Each input record 
is read, using one of two read blocks. The 
first read control block contains the 
address of the SYSLIN buffer, the address 
of the SYSLIN DCB, and the block size and 
logical record length. The second read 
control block contains the address of the 
buffer for library records (object module 
buffer or load module buffer) , the address 
of the library DCB, and the block size and 
logical record length. A pointer is used 
to indicate which read control block is to 



be used for the input record. Initially, 
the pointer is set to the SYSLIN read con- 
trol block. 

The type of input processing required is 
determined by the following conditions: 

• For all object module records whose 
first column character is a blank, con- 
trol statement scanning is required, 
provided that the record is not encoun- 
tered "in module". (Control statements 
encountered within a module cause an 
error indication.) 

• Either object module processing or load 
module processing is required, depend- 
ing on the type of input module. Only 
object modules are read from SYSLIN. 
Input modules from libraries are iden- 
tified by record format. F format 
indicates object modules; U format 
indicates load modules. 

• At en d-of- input (from SYSLIN or 
SYSLIB) , include processing is required 
if more modules must be included before 
rerunning normal processing. 

• At end- of- input from SYSLIN, automatic 
library call processing is required if 
the NCAL option (no automatic library 
calls) was not selected. If the NCAL 
option was selected, input processing 
is complete. 

• If a NAME statement, which may indicate 
a multiple execution of linkage editor, 
is detected during control statement 
scanning, processing proceeds as if an 
end-of- input has occurred on SYSLIN 

(automatic library call processing is 
performed) . The next record is read to 
determine if end-of -input has occurred; 
if not, input processing will be 
repeated at the end of final 
processing. 

• If an end-of -input occurs on SYSLIN, 
but no valid input was received, link- 
age editor processing is terminated. 



Reading Blocked Input 

The linkage editor can accept blocked 
card image input from the SYSLIN data set 
and blocked object module records from the 
SYSLIB data set (or from a user's library) . 
Maximum block sizes allowed by the linkage 
editor are shown in Table 2. Generally, 
the record format, block size, and logical 
record length are established either when 
the data set is created, or when they are 
specified on the DD statement for the data 
set in an execution of the linkage editor. 
If the BLKSIZE field is not specified, the 
linkage editor assumes a block size of 80. 
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The logical record length (LRECL) is fixed 
at 80. 

Table 2. Block size Determination 

| Maximum Block size j Main Storage Available! 



I 
I — 



5 
10 



J44K (+xK) - 52K(+xK) 
-+- 



|52K(+xK) - 88K(+xK) | 



40 



|88K (+xK) - 9999K 

-J. 



H 

I 

-1 

|xK is the (optional) additional storage | 

| allocated to the load module buffer | 
| (i.e. r storage in excess of 3K) • j 

L J 

If the block size specified on primary 
input exceeds the allowable maximum (see 
Table 2) , or is not a multiple of the log- 
ical record length, an error message 
(IEW0594) is issued and linkage editor pro- 
cessing is terminated; if the invalid block 
size is specified on input from a library, 
the data set is ignored, but processing is 
not terminated. The block size specified 
by the user is used as the read count; if a 
short block is read, the linkage editor 
determines (via an exit at SYNAD) if the 
length of the short block is valid (a mul- 
tiple of the logical record length) , and 
the number of the logical records it 
contains. 

If SYSLIN is a concatenation of data 
sets, the input processor reexamines the 
block size fields whenever a data set 
boundary is crossed to determine if their 
values have changed. 



Blocked Output on SYSPRINT 

The logical record length for output to 
SYSPRINT is fixed at 121. If the BLKSIZE 
is not specified by the user, it is set 
equal to the logical record length. If the 
specified block size exceeds the allowable 
maximum (see Table 2) , or is not an inte- 
gral multiple of the logical record length, 
linkage editor processing is terminated and 
a condition code of 16 is returned. 



The general format for linkage editor 
control statements is shown in Figure 11. 
The control statement scanner interprets 
symbols enclosed in parentheses as "level 
1" symbols; symbols not enclosed within 
parentheses are "level 0." ENTRY, ALIAS, 
INSERT, and SETSSI control statement 
operands contain only level symbols. 
CHANGE statement operands always contain 
both a level symbol and a level 1 symbol. 



The operands of REPLACE, INCLUDE, OVER- 
LAY, and NAME control statements contain 
level symbols, or both level and level 
1 symbols. LIBRARY statement operands may 
contain level 1 , or both level and level 
1 symbols. The operation to be performed 
depends on the operand format. 
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Figure 11. Control Statement Scanner 
Operation 



Control Statements 

When an input record is found to be a 
control statement (blank in column 1) , it 
is scanned to detect format errors and con- 
tinuation of comments or operands. A vec- 
tor table is scanned to determine the 
appropriate processor; separate processing 
is required for each type of control state- 
ment (INCLUDE, REPLACE, LIBRARY, CHANGE, 
INSERT, OVERLAY, ENTRY, ALIAS, NAME, or 
SETSSI) . Diagram B1 illustrates general 
processing of each control statement type. 



The control statement scanner searches a 
vector table for the operation symbol to 
determine the associated control statement 
processor. It then analyzes the operands 
using two work areas, "0PD1" and "OPD0," 
and two pointers, "P1" and "P2." 0PD1 is 
used for level 1 operand symbols; OPD0 is 
for level operand symbols. P1 points to 
the operand symbol being analyzed; P2 
points to either OPD0 or OPD1, depending on 
the level of the operand symbol referred to 
by P1. 
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An operand symbol referred to by P1 is 
placed by the READ 8 routine into the work 
area referred to by P2. Parentheses and 
commas control the switching of pointer P2 
between the work areas. For example, when 
a left parenthesis is encountered, P2 moves 
to 0PD1 because a level 1 operand symbol 
will follow. When a comma, blank, or right 
parenthesis is detected, the PROCENTY rou- 
tine passes control to the control state- 
ment processor that was previously found 
during the search of the vector table. 



Control Statement Processors 

When the operand symbols have been read 
into work areas OPDO and 0PD1 , control is 
passed to the control statement processor 
at the saved entry point. Scanning of the 
control statement resumes when the control 
statement processor returns control. The 
individual control statement processors are 
described in the following paragraphs. 



INCLUDE STATEMENT PROCESSOR : The include 
statement processor builds a chain in the 
CESD of items to be included. Each item in 
the chain contains the address of the next 
item in the chain (in the chain/address 
field - bytes 9, 10, and 11). The last 
item in the chain contains zeros in this 
field. 



Chained include items have two kinds of 
subtypes: "include with pointer" and 
"include without pointer." In Figure 12, 
the statement INCLUDE M defines M as a 
sequential data set. The include statement 
processor creates an entry for the ddname M 



in the CESD with the subtype "include 
without pointer." 

In the statement INCLUDE LIBX (A) , A is 
defined as a member of a PDS. The include 
statement processor creates an entry for A 
in the CESD with the subtype "include with 
pointer." The pointer is in the chain 
pointer/ chain ID field (bytes 14 and 15) ; 
it contains the CESD line number of the 
ddname LIBX. A single ddname, such as 
LIBX, may be referred to by several 
pointers. 

In Figure 13, the statement INCLUDE 
TEMP(A,B,C) indicates that A, B, and C are 
members to be included from library TEMP. 
Member B contains the nested statement 
INCLUDE LIBX (U,V,W) ; this is the last 
statement processed in member B. The CESD 
is shown at the time when the control 
statement scanner has read operand V, but 
not W. The include statement processor has 
created a CESD line for operand V in the 
LIBX include chain. C is currently the 
last item in the TEMP include chain. When 
the control statement scanner reads operand 
W, the include statement processor enters a 
CESD line f or W between V and C; this pro- 
cess is distinct from the one that actually 
searches the members U, V, and C on the 
library. (Refer to the paragraph "Include 
Processor.") At the time chosen for this 
example, the data set member B is being 
read; data set member A has been read and 
therefore is no longer in the CESD as a 
member name, but data set members U, V r and 
C have not yet been read. 

The chained CESD entries created by the 
include statement processor are later pro- 
cessed by the include processor (Chart JR) . 
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Include Statement Processing With Nested Members 
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OVERLAY STATEMENT PROCESSOR : The overlay 
statement processor maintains a record of 
the current segment number and updates it 
by one each time a new OVERLAY statement is 
encountered. The relationship of segments 
in an overlay tree structure is kept in 
SEGTA1 (see Figure 14) . Entry n in SEGTA1 
contains the number of the segment that 
precedes the nth segment of the overlay 
tree structure (the next higher segment in 
its path) . The overlay statement processor 
creates a chain of overlay items in the 
CESD and updates SEGTA1 . If the level 1 
operand (REGION) is detected , the current 
region number is incremented by one, and a 
zero is entered as the previous segment 
number in SEGTA1 . 



node point would be established for B, and 
symbol B would again be entered in the 
CESD. 

INSERT STATEMENT PROCESSOR : The insert 
statement processor scans the CESD for the 
symbol indicated in the INSERT statement. 
If the symbol is found, the segment number 
field is changed to the number of the seg- 
ment that contains the INSERT statement. 
If the symbol is not found in the CESD r a 
new ER-type CESD entry is created. In 
either case, the new CESD entry is marked 
"insert" in the subtype field, and the seg- 
ment number of the INSERT statement is 
placed in the segment number field. 



If an OVERLAY statement is encountered 
that refers to a node point higher in the 
overlay tree structure, all symbols identi- 
fying node points higher in the path are 
removed from the chain; their CESD lines 
are marked "null." For example, in Figure 
14, when the statement OVERLAY A is encoun- 
tered after segment 4, the CESD entry for 
symbol B is marked null and is no longer in 
the chain. If an OVERLAY B statement was 
encountered at the end of segment 5, a new 



REPLACE AND CHANGE STATEMENT PROCESSORS : 
The replace and change statement processors 
build a chain of CESD entries. Each entry 
to be replaced, changed, or deleted is so 
marked in the subtype field. The ESD pro- 
cessor examines the replace/change chain 
before processing any ESD item. Since a 
REPLACE or CHANGE statement applies only to 
the module that immediately follows it in 
the input, the replace-change chain is 
removed from the CESD at the end of the 
module. 
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Note ; In this example, card OVERLAY C has just been 
read. Name B is no longer in the chain. 

Figure 14. Overlay Statement Processing 



When a REPLACE statement or a CHANGE 
statement operand contains two symbols , 
such as CHANGE A (B) , A and B are entered 
in consecutive lines of the CESD. Only the 
first line of the pair (the line for A) 
contains the address (in the chain address 
field) of the next item in the replace/ 
change chain. 



NAME STATEMENT PROCESSOR ; The name state- 
ment processor places an entry in the all 
purpose table containing the name under 
which the following input module is to be 
STOWed in the PDS directory. If the 
operand contains the level 1 symbol (R) , a 
bit is set to indicate that the module is 
to be STOWed as a replacement for a module 
of the same name. Another bit is set to 
indicate that a NAME statement was encoun- 
tered; the input processor tests this indi- 
cator and terminates input operations for 



this load module if it is set. If a NAME 
statement is received from any input source 
other than SYSLIN, the error routine is 
entered; NAME statements are accepted only 
if they are in the primary input. 

SETSSI STATEMENT PROCESSOR : The SETSSI 
statement processor converts the eight 
bytes of hexadecimal information specified 
on a SETSSI statement to a 4-byte field , 
and enters it into the APT. During final 
processing, this information is entered 
into the system status index , a 4-byte 
extension of the user data area in the PDS 
directory. The index contains information 
describing the status of members in the 
library and is used for maintenance 
purposes. 

ENTRY STATEMENT PROCESSOR : The entry 
statement processor places the symbol spe- 
cified in an ENTRY statement in the all 
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purpose table. The symbol will override 
any symbol specified in an END statement as 
the entry point for the module. 

ALIAS STATEMENT PROCESSOR ; The alias 
statement processor creates chained CESD 
entries for a maximum of five alias names 
specified in ALIAS statements. During 
address assignment r these entries are used 
to build the alias table. 



LIBRARY STATEMENT PROCESSOR : The library 
statement processor creates chained CESD 
entries for the operands specified in 
LIBRARY statements; a chain is created for 



each distinct library. Each chain begins 
with a library ddname and contains all 
member names specified for the library (see 
Figure 15) . 

A member name specified in a LIBRARY 
statement can result in two kinds of ER 
subtypes: "matched library member" or 
"unmatched library member." If a CESD 
entry is created for a member name speci- 
fied in an input ER and also specified in a 
LIBRARY statement, it is called a "matched 
library member." However r if the member 
name was specified only in a LIBRARY state- 
ment , the entry subtype is "unmatched 
library member." 



Register 2 



f LIBRARY LIB! (MARY) 



( LI BRARY LI B2 (SAM, PETE f 
( LIBRARY LIB1 (JOE) ' 



r 



L 



All Purpose Table 



Symbol 


Type 


Chn Addr 
/ Reverse 
Chain ID 


Seg 
No 


Sub 
Type 


Chn Pointer/ 
Chain 
Length/I D 


JOE 
PETE 


02 
02 






00 
00 





Diagram A 









Chn Addr/ 




Sub 


Chn Pointer 




Symbol 


Type 


Reverse 


Seg 


Chain 








Chain ID 


No 


Type 


Length/ID 


01 














02 














03 














04 


JOE 


02 


OC 




03 


0A 


05 














06 


LIB2 


02 


00 




B0 


07 


07 


SAM 


02 


06 




02 


08 


08 


PETE 


02 


07 




03 


00 


09 














0A 


MARY 


02 


04 




02 


00 


0B 














OC 


LIB1 


02 


00 




B0 


04 



Diagram B 









Chn Addr 






Chn Pointer 




Symbol 


Type 


/Reverse 


Seg 
No 


Sub 


Chain 








Chain ID 


Type 


Length/ID 


01 














02 














03 














04 


JOE 


00 










05 














06 


LIB2 


02 


00 




B0 


07 


07 


SAM 


02 


06 




02 


08 


08 


PETE 


02 


07 




03 


00 


09 














0A 


MARY 


02 


OC 




03 


00 


0B 














OC 


LIB1 


02 


00 






B0 


0A 



Diagram C 

Figure 15. Library Statement Processing 



Notes : 

• The CESD shown in diagram B results from the CESD shown in diagram A after 
reading in three library cards. A chain with direct and reverse pointers is 
created for LIB1 and also for LIB2. 

• JOE and PETE were ERs (subtype 00) and became "matched library member" 
(subtype 03) . 

• SAM and MARY were not previously in the CESD. They are created as "unmatched 
library member" (subtype 02). 

• The CESD shown in diagram C results from the CESD shown in diagram B after 
reading in an input module containing the ER MARY and the SD JOE. (Only the 
library chains are shown). 

• JOE is removed from the chain in diagram C, and the chain pointers are modified. 

• MARY becomes a "matched" subtype and will be called by the automatic 
library call processor (unless resolved by other input). 

• SAM remains "unmatched" and will be ignored by the automatic library call 
processor (unless matched in other input). 
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Object Module Processing 

If input to be read by linkage editor 
consists of object modules (F record format 
indicates object modules from a library) 
the following operations are performed: 

• Determine record type 

• Set up general registers 

• Special event processing 

The record type is determined by examin- 
ing columns 2 through 4 of each logical 
input record. For each record type (SYM, 
ESD, TXT, RLD, END) , special processing is 
required. 

The general registers are loaded with 
input record information to be used in the 
required processing, as described in Table 
3. 

Following is a description of special 
event processing: 

• When end-of -input is detected, any data 
still contained in the input RLD buffer 
or the input text buffer is written out 
on SYSUT1, if necessary. 

• If the TEST option is selected, the SYM 
records from the object module are 
gathered in the input RLD buffer. When 
the first TXT statement in a module is 



encountered (or if no text statement 
has been encountered when the END 
statement is detected) , the contents of 
the input RLD buffer are written out on 
SYSLMOD. 

When ESD processing is completed, indi- 
cators in the all purpose table are 
examined to determine if: 

1. A control section (SD, PC, or com- 
mon) was indicated on the ESD 
statement. 

2. The TEST option was specified. 

If both conditions are met, the ESD 
record is blocked with any other ESD 
records in the input RLD buffer. 

If a control statement continuation is 
expected and an object module record is 
read, an error condition occurs, and a 
coded diagnostic message is produced. 
Normal object module processing is then 
performed on the record. 

If, during object module processing, a 
statement is encountered which is not 
one of the five acceptable types (SYM, 
ESD, TXT, RLD, or END) , an error condi- 
tion occurs and a diagnostic message is 
produced. The input record is then 
ignored. 



Table 3. General Register Information - Object Module processing 
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Load Module Processing 

Load modules included in the input to 
linkage editor are processed in the follow- 
ing manner : 

• The input record type is determined by 
an identification field (byte 1 of the 
record) , as shown in Table 4. Special 
processing is performed for each record 
type. 

• The parameter registers are loaded with 
input record information to be used in 
the required processing r as described 
in Table 5. 

• If the record is not identified as a 
TXT r CESD r Scatter/Translation, SYM, or 
CCW/RLD record, an error condition 
occurs, and a diagnostic message is 
printed out. The input record is 
otherwise ignored. 

• If the TEST option was not specified on 
the EXEC statement, all SYM records are 
ignored. 

• If an end-of -module indication is found 
in a CCW or RLD record, cleanup func- 
tions are performed. 

• When a CCW record is detected, the fol- 
lowing TXT record is immediately read 
into the input text buffer if it is not 
to be deleted. 

• If the TEST option was specified on the 
EXEC statement and a SYM record is 
received, the record is written out as 
test translation data from the RLD 
input buffer. 

The following text describes the special 
processing performed, during object and 
load module processing, for the ESD, TXT, 
RLD, and END records. 



Table 4. Record Types 

r r 1 

| Record Type (Identifier | 

y + ^ 

I TXT j * j 

| CESD j hex' 20' | 

j Scatter/Translation | hex' 10' | 

| SYM | hex" 40" | 

| CCW j hex' 01 ■ | 

| CCW/RLD j hex" 03 ■ | 
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,. T .| 

| CCW jhex'OD' j 

| CCW/RLD | hex" OF • | 

j RLD jhex'OE' | 

|. ±_ ^ 

(♦Identified by preceding control record | 

L J 



ESD Record Types 

Every object module in the input to 
linkage editor must contain at least one 
ESD item. An ESD item is created by a lan- 
guage translator whenever it finds a symbol 
that is defined for external use. In the 
assembler language, for example, ESD items 
are created whenever an ENTRY, EXTRN, COM, 
START, or CSECT statement, or a V-type 
address constant is found. An ESD item is 
created to define the beginning of each 
control section, and to define a common 
area. Each ESD item has a type assigned to 
it that indicates its function. The ESD 
types are: 

• Section Definition (SD) . Defines the 
beginning of a named control section. 

• Private Code (PC) . Defines the begin- 
ning of an unnamed control section. 

• Label Definition (LP) . Defines a label 

(symbol) whose location is defined 



Table 5. General Register Information - Load Module Processing 
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relative to the location of the control 
section in which it is contained. An 
LD type ESD item contains the ESD ID of 
the control section that contains the 
label. 

• Common (CM) . Defines a common area for 
which a main storage address is 
assigned during linkage editor proces- 
sing. The area may be named or 
unnamed; an unnamed area is referred to 
as a "blank common" area. 

• Pseudo Register (PR) . Defines an area 
external to the output module r but 
referred to by it, for which main 
storage space is allocated at execution 
time. The linkage editor treats PR 
symbols as a block that is external to 
the program. The value assigned to 
each symbol is a displacement within 
this block. 

• External Reference (ER) . Refers to a 
symbol that is referred to but not 
defined within an input module. 



CESD Record Types and Subtypes 

A load module in the input to linkage 
editor contains at least one CESD record 
(240 bytes , maximum) . The CESD record 
types are the same as for ESD records, with 
the following additions: 



• Null type . This indicates that the 
item is to be ignored in any reproces- 
sing of the module by linkage editor. 



• Label Reference (LR) . This defines a 
label (symbol) within a control sec- 
tion. An LR type CESD entry is num- 
bered; it contains the ESD ID of the 
control section entry in the ID/length 
field. An LR may be referenced direct- 
ly by an RLD item in the same module, 
whereas an LD may not. All LD items 
are changed to LR items during linkage 
editor processing (LDs are contained 
only in object modules, never in load 
modules) . 



• Private Code (PC) Marked Delete . This 
is a CESD item created only for ENTABs 
and SEGTABs. PC-delete entries are 
placed in the renumbering table, indi- 
cating that associated TXT and RLD 
information is to be deleted. 



CESD items may also contain a "subtype. 
The subtypes are listed in the internal 
CESD format in the Appendix (Section 7) . 



ESD Processing 

The main function of ESD processing is 
symbol resolution. Individual ESDs in the 
input to linkage editor are combined into a 
composite ESD, which contains all symbols 
in the input which were not changed, 
deleted, or replaced. A chained REPLACE/ 
CHANGE list (produced by the control card 
scanner) specifies which ESD items are to 
be changed, deleted, or replaced. A 
renumbering table (RNT) is also produced 
during ESD processing; it is used during 
TXT, RLD, and END processing to translate 
the ESD ID of the input ESD items to CESD 
IDs. Diagram B2 provides a general illus- 
tration of several types of ESD processing. 

At the beginning of ESD processing, con- 
trol information from the ESD record is 
saved: the ESD ID of the ESD record, the 
number of bytes of ESD information, and the 
type field of the first ESD item. The cur- 
rent segment number is placed in the ESD, 
unless it is a PR-type (PRs have an align- 
ment value in the segment number field) . 
If the automatic library call indicator is 
on, the segment number is set to 1 so that 
called modules will be placed in the root 
segment. The ESD item is then processed 
according to its type, in the following 
manner: 

• If the ESD item is an ER, bytes 10, 11, 
and 1 2 are set to zero in the input 
buffer (either the object module buff- 
er, the SYSLIN buffer, or the first 
pass RLD input buffer) . Byte 10 must 
be cleared because automatic library 
call processing uses it to indicate if 
automatic library calls have been pro- 
cessed. Bytes 11 and 12 must be 
cleared because any nonzero data 

(including blanks) will be entered in 
the delink table if delinking is 
required for the symbol. If the input 
item is an ER item from an object 
module, the CESD subtype field is also 
reset to zero to indicate that there 
are no modifiers in the subtype field. 

• If a REPLACE/CHANGE function has been 
requested for the input module, the 
REPLACE/CHANGE chain that was built in 
the CESD by the control statement 
scanner is examined and the appropriate 
modifications are made. For example , 
if the scanner received the statement 
CHANGE A (B) , the CESD contains a line 
for A, marked as a change statement 
item in the subtype field; the next 
line contains the symbol B. The input 
ESD item symbol is changed from A to B 
during ESD processing. 

• If the ESD item is a PC, the CESD is 
not searched because each PC entry is 
treated as a unique entry. The PC is 
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placed in the next available CESD line 
and is processed in the same manner as 
an SD. 

• If the ESD item is NULL, the renumber- 
ing routine is entered. (This routine 
is described in "Non-Resolution 
Processing.") 

• If the ESD item is an LD, it is changed 
to an LR. The item is then processed 
as an LR. (There are some minor dif- 
ferences in processing LDs that have 
been changed to LRs; for this reason, 
an internal indicator is set when the 
type is changed to LR.) 

After the ESD type is determined , the 
CESD is scanned for a matching symbol. If 
no match is found, non-resolution proces- 
sing is performed. If the input ESD symbol 
matches a symbol in the CESD, resolution 
processing is performed. Resolution pro- 
cessing results in only one CESD entry for 
each unique input ESD symbol; multiple 
occurrences of the same input ESD symbol 
are listed in the renumbering table (RNT) 
with pointers to the single CESD entry. 



NON-RESOLUTION PROCESSING : If no matching 
symbol is found in the CESD, the input ESD 
item is processed as described in the fol- 
lowing paragraphs. 

SD Items ; If the input ESD item is an SD 
(see Diagram B2, Area A) : 

• The Freeline routine selects an empty 
line in the CESD. The line following 
the current line is chosen unless a 
previous CESD line is marked null. 

(Null lines are used whenever possible 
to save space.) 

• If automatic library calls are being 
processed, an indicator is set in the 
type field of the selected CESD line. 

(If a module map was requested, this 
indicator is checked during module map 
processing. If the indicator is set, 
the control section is marked with an 
asterisk in the module map or cross 
reference table to indicate that it was 
obtained from a library during automat- 
ic library call processing.) 

• A "write" indicator is set in the all- 
purpose table to note that SDs, PCs, or 
CMs were encountered in the input rec- 
ord. When ESD processing is completed, 
the write indicator is tested. If it 
is on and the TEST option was speci- 
fied, ESD records containing SDs, PCs, 
or CMs are saved, blocked into 244-byte 
records (including four bytes of con- 
trol information) , and written out on 
SYSLMOD. 



• In any input object module the CESD 
line number of the first SD entry whose 
length is zero is saved. END proces- 
sing uses this CESD line to enter the 
length specified on the END card. 

• The enter routine creates a CESD entry 
for the input ESD item; it moves the 
symbol, length, segment number, ID, and 
type into the selected CESD line. 

• The renumber routine places the line 
number of the new CESD entry into the 
renumbering table to provide a means of 
translating the input IDs to the new 
CESD IDs. For example, if the input 
ESD item has a line number (ESDID) of 3 
but the item is placed into the CESD at 
line 5, 5 is placed in the third line 
of the renumbering table. (For each 
input ESD line, except LD lines, there 
is a corresponding RNT line. The RNT 
contains information for the current 
module; it is set to zero at the end of 
each input module.) 

ER Items ; If the input ESD item is an ER, 
it is entered in the CESD and renumbered as 
described above; no special processing is 
required. 

CM Items : If the input ESD item is CM (see 
Diagram B2, Area E) , a "common" indicator 
is set and the item is treated as a delete 
item. If the address that was assigned to 
the CM item by the language translator is 
not zero, it is saved in the delink table 
for later use. (Two CM items with the same 
identifying symbol may have different 
assigned addresses; therefore, the assigned 
address in the input must be subtracted 
from all address constants that refer to 
the CM items so that they are returned to 
their displacement value before reloca- 
tion.) The CM item is then renumbered and 
entered into the CESD. 

LR (or LD) Items : If the input ESD item is 
an LR or LD (see Diagram B2, Area C) : 

• When processing an LR, the Label rou- 
tine determines if the SD for the con- 
trol section has been processed. If 
the SD has not been received, any LRs 
that refer to that SD are chained 
together in the CESD until the SD is 
received. (The SD might be marked 
replace; therefore, the LR cannot be 
processed until the SD is received.) 
When the SD is received all dependent 
LRs are processed. Each LR ID field is 
renumbered using the renumbering table 
so that it refers to the CESD ID of the 
SD. 

• LDs are not renumbered because they are 
not referred to by RLDs and are not 
numbered in language translator output. 
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The enter routine places them directly 
in the CESD. If an LD is received 
before the SD to which it belongs, it 
is handled as an LR. 

PR Items ; If the input ESD item is a pseu- 
do register r the current segment number is 
not entered in column 12 of the ESD item 
(Chart JE) . Column 12 of a PR item may 
contain an alignment value which indicates 
that the PR must be aligned to a half word, 
fullword, or doubleword boundary. The PR 
is then processed by the freeline, enter, 
and renumber routines, as described 
previously. 



RESOLUTION PROCESSING : If a matching sym- 
bol is found in the CESD, the type fields 
of the input item and the matching CESD 
item are compared and resolution processing 
is then performed. The following conven- 
tions are observed during resolution 
processing: 

1 . Input PR items may match only PR- type 
entries in the CESD. If a PR-type 
input item matches a non-PR item in 
the CESD, it is not treated as a 
match; the CESD search for a matching 
PR item continues. 

2. If the matching CESD item is marked 
M chained, M resolution is performed on 
the item to which it is chained. 

3. If the CESD line is marked null, the 
match is ignored and the search 
continues . 

4. If the CESD item is an ER produced 
from a REPLACE, CHANGE, OVERLAY, or 
ALIAS statement, or from the ddname 
field of an INCLUDE or LIBRARY state- 
ment, the match is ignored and the 
search continues. 

Matching items are processed in the fol- 
lowing manner: 

• If the input ESD item is CM, SD, or LR, 
and it matches an ER in the CESD, the 
input type replaces the type indicated 
in the CESD item (see Diagram B2, Area 
B) . Non-resolution processing is then 
performed on the input item. 

• If the input ESD item is an LR and it 
matches a CM, SD, or LR in the CESD, a 
"match" bit is set, indicating that a 
double symbol definition is possible. 
If the SD for the control section has 
been entered in the CESD and is marked 
for deletion, the label routine deletes 
the label; if it is not marked for 
deletion a "double symbol definition" 
message is produced. If the SD for the 
control section is not in the CESD, the 



LR is chained to the matching LR; when 
the SD is received, the LR is deleted 
or a double symbol definition is pro- 
duced, depending on whether or not the 
SD is being deleted. 

• If an input PR matches a PR in the CESD 

(Diagram B2, Area D) , the greater 
length and the most "constrictive" 
boundary alignment are placed in the 
CESD entry. (A doubleword alignment is 
more constrictive than fullword align- 
ment; fullword is more constrictive 
than half word; etc.) The input PR 
entry is then renumbered to the updated 
PR entry in the CESD. 

• If an input SD item matches an SD entry 
in the CESD, automatic replacement of 
the control section occurs. The input 
SD item is entered into the CESD as a 
delete- type and is chained to the 
matching SD entry. (During second pass 
processing, the assigned address of the 
control section being replaced will be 
subtracted ("delinked") from the 
addresses of any non-branch type 
address constants that refer to the 
ER- delete entry.) The SD-delete item 
remains chained only while the module 
is being processed; END processing will 
change the chained items to null-type 
entries. (Refer to "Delinking Non- 
Branch Type Address Constants.") 

• If an input SD item matches a CM entry 
in the CESD, the greater length is 
entered in the length field of the SD 
entry. If the program is in overlay, 
the common path routine scans SEGTA1 to 
find the segment in the overlay struc- 
ture that is common to both items and 
places the segment number in the SD 
entry. The SD item is then written 
over the CM line and renumbered. (This 
is referred to as "automatic promotion 
of common.") 

• If an input SD or CM item matches an LR 
in the CESD, a "double symbol defini- 
tion" message is produced and the SD or 
CM item is entered in the CESD as a 
delete-type item and is chained to the 
matching LR entry, causing the SD or CM 
to be replaced. 

• If the input item is CM, it may be 
"blank common. " Blank common may match 
a PC-type CESD item because both con- 
tain blanks in the symbol field. In 
such a case, the match is ignored and 
the search continues. 

• If an input CM item matches an SD or CM 
item in the CESD (Diagram B2, Area F) , 
the greater of the two lengths is 
entered in the CESD item. (The CESD 
type is not changed.) If the module is 
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being processed for overlay, the seg- 
ment number of the segment common to 
both the input item and the CESD item 
is also entered in the CESD item (auto- 
matic promotion of common) • 

• Whenever an input ER item matches an ER 
in the CESD, both the type and subtype 
fields are examined; the ER items are 
then resolved in the following manner: 

1. If the subtype fields of both ER 
items are not marked, the input 
item is not entered into the CESD; 
the matching ER remains in the 
CESD and a pointer to it is placed 
in the renumbering table entry for 
the input item. 

2. If both items are marked "delete," 
the new ER is entered into the 
CESD and the old item remains 
there so that they can be delinked 
individually (in this case, the 
CESD may contain two ER items for 
the same symbol) . Delinking is 
described in "Second Pass 
Processing." 

3. If the input ER item is marked for 
deletion, but the ER item in the 
CESD is not marked delete, the 
input ER is chained to the match- 
ing ER in the CESD. The chained 
ER item remains in the CESD until 
the end of module is detected so 
that the delink value can be 
saved. 

4. If the input ER item is not marked 
for deletion and the ER item in 
the CESD is marked "delete" or 
"replace," the delete bit in the 
subtype field is cleared (delete 
is changed to replace) and the 
item is renumbered. If the match- 
ing ER item in the. .CESD is marked 
"no call" or "library member" it 
is marked "matched" before 
renumbering. 

5. If the input ER item is marked in 
the subtype field, but is not 
"delete" or "replace," it is 
assumed to be "never call"; if the 
matching ER item in the CESD is 
"library member," the CESD item is 
removed from the chain of library 
members and the input ER item is 
entered into the CESD and 
renumbered. 

TXT Processing 

The manner in which TXT records are pro- 
cessed depends on whether they are part of 
a load module or an object module. A load 
module contains records in a specified 



order. However, in an object module the 
records may not be in the proper sequence 
because the language translator may have 
created them out of order. (The restric- 
tions on linkage editor input are described 
in the Appendix under "Input Conventions.") 
Diagrams B3 and B4 illustrate processing of 
TXT records from object and load modules, 
respectively. 

Before any address constants can be 
relocated within a control section of an 
object module, all TXT records must be 
placed in the proper order. This is done 
in the input text buffer (TXTBFBEG) , which 
is variable in length, allowing grouping of 
data within the buffer. 

Each "multiplicity" of text is assigned 
a number as it is moved (or read) into 
TXTBFBEG. A multiplicity is a portion of 
text equal in length to the maximum size of 
a SYSLMOD output record. Within each con- 
trol section, multiplicity numbers are 
assigned consecutively, starting at 0. 

Text records from object modules contain 
both text data and the control information 
needed for processing. Text records from 
load modules contain only text, so the 
associated control record must also be 
examined to obtain the required control 
information. During object module proces- 
sing, control information is placed in 
registers; this information allows the 
object module text to be moved from the 
object module buffer into TXTBFBEG. For 
load module text, the assigned address of 
the first byte of text and a pointer to the 
ID-length list (in the control record) is 
determined during load module processing. 
This information allows the text record to 
be read directly into TXTBFBEG. 

Processing Object Module Text 

When text is received from an object 
module, the text record ID is renumbered, 
using the renumbering table, so that it 
refers to the CESD entry for the control 
section which contains the text. The size 
of the control section is obtained from the 
CESD, and a test is made to determine if 
the whole control section or a multiplicity 
(whichever is smaller) will fit into the 
space available in TXTBFBEG. (If the con- 
trol section length was not specified in 
the CESD entry, only text for the current 
ID is accepted; refer to the 'paragraph 
headed "No-Length Control Sections.") 

If there is sufficient space in TXTBFBEG 
to accommodate the control section or mul- 
tiplicity, the text is moved into the buff- 
er, and an entry (containing the ID and 
multiplicity number of the text) is made in 
the text I/O table . A corresponding entry, 
containing the location of the multiplicity 
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and the length of the text, is made in the 
text note list. The text note list entry 
also contains a displacement field. When 
text is in order, or on the first occur- 
rence of text for a multiplicity, the dis- 
placement field is set to 0; for out-of- 
order text the displacement field contains 
the displacement from the beginning of the 
multiplicity of the first byte of contigu- 
ous text. 

If the SYSUT1 record size is smaller 
than the multiplicity size, each multipli- 
city is divided into pieces, each piece 
having a length equal to the SYSUT1 record 
size. New text I/O table and text note 
list entries are made for each piece; the 
displacement field will contain the displa- 
cement of each piece from the beginning of 
the multiplicity. 



NO-LENGTH CONTROL SECTION: 



When text is 



received for a no-length control section (a 
control section for which no length is spe- 
cified in its CESD item) , space for one 
multiplicity is allocated in TXTBFBEG. 
Entries are made in the text I/O table and 
the text note list for the multiplicity, 
and the text is moved into TXTBFBEG. This 
procedure is repeated for each subsequent 
multiplicity of text for the no-length con- 
trol section. If TXTBFBEG becomes full, 
its contents are written onto SYSUT1 as 
described below in the section headed 
"Writing Text on SYSUT1". When the length 
is received, it is entered in the text note 
list. 

PROCESSING OUT-OF-ORDER TEXT : A load 
module contains records in a definite 
order. However, records in an object 
module may not be in the proper sequence 
because the language translator may have 
created them out of order. 1 Such records 
may contain discontinuities in addresses 

(due to a reorigin or a disjointed control 
section) , or they may not be contiguous 

(i.e., text of a given ID and multiplicity 
may be interspersed with text of other IDs 
or multiplicities) . Records of contiguous 
text must be built on SYSUT1 so that during 
second pass processing the text can be 
placed into its proper position, within its 
ID and multiplicity, in the second pass 
text buffer. 

The first occurrence of a given ID and 
multiplicity is read into the input text 
buffer as it is received. Discontinuities 
and non- contiguous text are of no conse- 
quence at the first occurrence of an ID and 
multiplicity. However, once text of a 
given ID and multiplicity has been written 



*The restrictions on linkage editor input 
are described in Appendix A under "Input 
Conventions . " 



out on SYSUT1, any subsequent text of that 
ID and multiplicity must be contiguous to 
be written out on SYSUT1 within each text 
record. 

Text of a previously-written ID and mul- 
tiplicity is read into the input text buff- 
er until a discontinuity, or text of a dif- 
ferent ID or multiplicity, is encountered. 
The contiguous text in the buffer is then 
written out on SYSUT1. The discontinuous 
(or non- contiguous) text is then placed in 
the buffer. If this text represents the 
first occurrence of an ID and multiplicity, 
the buffer is loaded without regard for 
discontinuities or non- contiguous text. If 
the text belongs to a previously-written ID 
and multiplicity, the text processor will 
again place only continuous text of that ID 
and multiplicity in the buffer. 

A record that contains non- contiguous 
text is called a "loose" record; a record 
that contains contiguous text is called 
"dense. " The text note list entry for a 
dense record usually has a nonzero value in 
the displacement field. When the text is 
read back from SYSUT1 into the second pass 
text buffer, during second pass processing, 
this displacement is used to place the text 
in its proper position within its ID and 
multiplicity. 



Processing Load Module Text 

Since text records from load modules are 
ordered and well-defined, they require 
little further processing by the text pro- 
cessor. The information in the ID- length 
list (in the control record) is scanned, 
and each ID is renumbered and checked to 
determine if it is to be deleted. If all 
IDs are to be deleted, the record is 
ignored, and control is returned to the 
input processor. 

When an ID that is to be processed is 
found, the text record containing the ID 
must be read into TXTBFBEG. The text rec- 
ord length is obtained from the associated 
control record and compared against the 
free space available in TXTBFBEG. If suf- 
ficient space is available, the text record 
is read into the buffer; otherwise, the 
contents of the buffer is written onto 
SYSDT1 to ensure sufficient space, and the 
record is read. 

Text is processed in the buffer in the 
order specified by the ID-length list (in 
the control record) . IDs that are to be 
deleted are overlaid by IDs that are to be 
processed. The text is divided into multi- 
plicities and entries are made in the text 
I/O table and the text note list. When all 
text identified by the ID-length list is 
processed, text processing is completed. 
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Writing Text on SYS0T1 

When no more control sections can be 
accommodated in TXTBFBEG, the contents of 
the buffer must be written onto the inter- 
mediate data set (SYSUT1) . The text I/O 
table is scanned to determine the order in 
which control sections are to be written. 
The length of the first control section 
(i.e. r corresponding to the first text I/O 
table entry) is obtained from its corres- 
ponding ESD ID; if the length is less than 
the size of the SYSUT1 record, the text I/O 
table entry for the control section is 
marked "written." Each subsequent control 
section is similarly processed , and its 
length is added to the sum of the lengths 
of previously processed control sections. 

When the sum of control section lengths 
reaches the limit of a SYSUT1 record, the 
entire group of control sections is written 
onto SYSUT1. The relative track address 
(TTR) is placed in the text note list entry 
corresponding to the last text I/O table 
entry that was processed. 

When a single control section is larger 
than a SYSUT1 record, the multiplicities of 
the control section are grouped, up to the 
limit of the SYSUT1 record size, and 
written. 1 When control sections or multi- 
plicities are grouped on SYSUT1, the multi- 
plicities must be in ascending consecutive 
order. If the overlay option has been 
specified, no grouped control sections are 
permitted on SYSUT1. 

Note : Each time an entry is made in the 
text note list during text processing, a 
check is made to determine if the list is 
full. If it is full, the contents of 
TXTBFBEG are grouped (if possible) and 
written onto SYSUT1 , and the TTRs are 
placed in the text note list. The list is 
then written onto SYSUT1 , and its address 
is noted in the I/O control table . The 
text note list may be written a maximum of 
three times. 

If neither TXTBFBEG nor the text note 
list becomes full during text proccessing, 
no text is written onto SYSUT1. The text 
is retained in the buffer, and single-pass 
processing is in effect for text records. 



RLD Processing 

RLD processing basically consists of: 

1. Updating each set of relocation and 
position pointers (R and P pointers) 



1 If the SYSUT1 record size is smaller than 
the SYSLMOD record size, no grouping is 
permitted. 



2. Processing each flag and address (FA) 
in the input item until the end of the 
record or the next item with an R and 
P pointer is detected. 

RLD records from object modules and load 
modules are processed in the same manner. 
During object or load module processing, a 
pointer to the first RLD record encountered 
in a load module or object module record is 
placed in register 6. 



RLD information is grouped in the RLD 
buffer by P pointer. Each P pointer of an 
input RLD record refers to the ESD entry in 
the input module for the control section 
that contains the address constant. Each 
time a new P pointer (one referring to a 
different ESD ID) is detected, an entry is 
made in the RLD note list for the RLD set 
(a set being an unbroken sequence of RLD 
items having the same P pointer) . The RLD 
note list entry contains the following 
information for each set: 



1 . The renumbered P pointer to which 
these RLDs refer. 

2. The lowest multiplicity of text to 
which these RLDs refer. 

3. The number of bytes of RLDs. 

4. The storage address of the first byte 
of RLD data if all RLDs remain in 
core; if RLDs are written onto SYSUT1, 
this field contains the accumulated 
byte count for intermediate chains, or 
the TTR of the record on SYSUT1. 



All adjacent RLD items containing the 
same P pointer are referred to by only one 
RLD note list entry. Adjacent RLD items 
containing the same R and P pointers are 
chained, with the R and P pointers appear- 
ing only once, at the beginning of the 
chain. The remaining RLDs in the chain are 
compressed by setting the flag indicating 
continuation and discarding the four bytes 
containing the R and P pointers. 



Each R pointer of an input RLD record 
refers to the ESD entry in the input module 
on whose value the address constant 
depends. The R and P pointers are updated, 
using the renumbering table. Before 
renumbering, the R and P pointers refer to 
ESD entries of the input module that con- 
tains the RLD items. The pointers are 
renumbered so that they point to the proper 
entries in the CESD being created for the 
output load module. If the R pointer 
refers to a deleted ESD entry, delinking 
may be performed. If the assigned address 
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of the symbol referred to by the address 
constant is zero, the address constant is 
not delinked, (Normal relocation is per- 
formed.) When delinking is necessary, an 
entry is placed in the delink table (a 
function of ESD processing) . The delink 
table entry contains the address (delink 
value) of the symbol being deleted and the 
CESD entry number of the identically named 
symbol that is to replace the deleted 
symbol. 



an ER or marked delete, the RLD flag 
field is not marked. This indicates to 
second pass processing that the address 
constant is to be relocated by absolute 
relocation; second pass processing uses 
the linkage editor assigned address of 
the symbol in the output module as a 
relocation factor for the value of the 
address constant. (This procedure is 
described in the paragraph "Second Pass 
Processing. w ) 



The ID of the delink table entry for the 
deleted symbol is saved in the renumbering 
table, and a "delink value saved" indicator 
is set. The ID of the indentically-named 
symbol and the ID of the new delink table 
entry are saved because they are later used 
to complete the delinking operation. The R 
pointer of the RLD item must be modified to 
refer to the delink table entry for the 
deleted symbol, but the original R pointer 
is needed to process any V-type address 
constants referred to in the RLD item. 
Therefore, the R pointer is not modified 
until the string of flag-address (FA) 
fields following the R and P pointers has 
been processed as described below. At that 
time, if the module is to be structured for 
overlay and it contains V-type address 
constants 1 that refer to the symbol, the ID 
of the identically-named symbol is inserted 
into the calls list. 



Each FA field of the RLD record is pro- 
cessed as follows: 

• The high-order bit of the flag field is 
set to zero. 

• If the address constant is an A-type, 
the renumbering table entry referred to 
by the R pointer is checked to deter- 
mine if it is marked as a PR type. If 
it is a PR, the RLD flag field is also 
marked PR (because second pass proces- 
sing must handle PRs in a special mann- 
er) . If the renumbering table entry is 
not an ER or marked delete, the RLD 
flag field is marked for relative relo- 
cation. This indicates to second pass 
processing that the difference between 
the origin of the control section in 
the input and the origin assigned by 
the linkage editor is to be used as a 
relocation factor for the value of the 
address constant. If the RNT entry is 



11 V- type address constants do not require 
delinking, but may be in a FA string with 
A-type address constants that do require 
delinking (or other control sections in 
the same input module may contain A-type 
address constants that refer to the 
deleted control section) . 



If the address constant is a 4-byte 
V-type ("branch-type") , and the program 
is in overlay, an entry is placed in 
the calls list, provided that the 
address constant refers across control 
sections (R not equal P) . The calls 
list is used during address assignment 
processing to determine which segments 
require ENTABs, and the number of 
entries each ENTAB must contain. 



• For both A-type and V-type address con- 
stants, the multiplicity of the address 
field is determined and is saved in the 
RLD note list if it is lower than any 
previous multiplicity in the RLD rec- 
ord. If two- pass processing is in 
effect, the RLD note list is used dur- 
ing second pass processing to read back 
RLD data from SYSUT1 (each RLD note 
list entry contains the relative track 
location (TTR) of an RLD record on 
SYSUT1) . The second pass processor 
uses the multiplicity field of the RLD 
note list entry to determine if the 
associated RLD record should be read 
back from SYSUT1 for a given multipli- 
city of text. 

When the last FA field in the string 
has been processed, all items in the 
string have been checked to determine 
if they require delinking. If any A- 
type address constants in the string 
required delinking, the R pointer for 
the string is modified to refer to the 
associated delink table entry. 



Table 6 shows the actions performed dur- 
ing RLD processing for each input flag for- 
mat, and the format of the flags after RLD 
processing. (The "output" column shows the 
flag formats that are passed as input to 
the relocation routine of second pass pro- 
cessing; refer to Table 7.) After all FA 
fields have been processed, the next RLD 
record is processed. 



If the RLD buffer becomes full, its con- 
tents must be written onto the intermediate 
data set (SYSUT1) . The RLD buffer is allo- 
cated with a maximum length less than or 
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equal to the size of a SYSUT1 record, so 
the entire buffer may always be written. 
As many consecutive RLD sets as possible 
are grouped in a SYSUT1 record. The RLD 
note list entry for each RLD set in the 
group contains a "grouped" indicator; the 
note list entry for the last RLD set in the 
group also contains the relative track 
address (TTR) of the group. 



Each time an entry is made in the RLD 
note list r a check is made to determine if 
the list is full. If it is full, the RLD 
sets in the RLD buffer are grouped and 
written onto SYSUT1, and the TTR is placed 
in the appropriate RLD note list entry. 
The RLD note list is then written onto 
SYSUT1, and its address is noted in the I/O 
control table . The RLD note list may be 
written a maximum of three times. 



RLD sets whose length exceeds that of a 
SYSUT1 record (requiring more than one out- 
put record) are not grouped. RLD note list 
entries for RLD sets that are not grouped 
contain the relative track address (TTR) of 
the SYSUT1 record and a M non-grouped" 
indicator. 



Note : If neither the RLD buffer nor the 
RLD note list becomes full during RLD pro- 
cessing, no RLDs are written onto SYSUT1. 
The RLD information is retained in the RLD 
buffer, and single-pass processing is in 
effect for RLDs. 



Table 6. Flag Field Processing 

r t 



I— 



Input 



# Flag 



+ 



Type 



-H 



Action Performed 



Output 



Flag 



Type 



-H 
-H 



0000LLST 



h 



Not PR, 
ER, CM, or 
delete 



Marked for relative relocation 



1 000LLST | Relative 



0000LLST 



h 



ER ( , 02" 
in renum- 
bering 
table) 



Marked for absolute relocation 



0000LLST 



Absolute 



0000LLST 



h 



+ 



Delete or 
CM ('OS') 



Marked for absolute relocation is assigned 
address of input item is zero 



0000LLST 



Absolute 



H 



0000LLST 



0000LLST 



PR ('06') 



+ 



Marked as PR (displacement value) 



Delete or 

CM 



Marked "delink value saved" if assigned 
address of input item is not zero 



0010LLST 






h 



-+- 



High-order 
bit of P 
pointer 



Pseudo 
Register 
Type 1 
., 

Delink 



-H 



0001LLST 



Type is 

not 

checked 



RLD is marked branch-type 



0001LLST 



Branch 



0001LLST 

or 
♦1001LLST 



Delete 



h 



Marked "delink value saved and other FA items 
in string exist that are non- branch type" and 
are being delinked 



High-order 
bit of P 
pointer. 



Delink 



-H 



0010LLST 



h 



Pseudo 
Register 
Type 1 



None - Remains as a PR (displacement value) 



0011LLST 






Type is 

not 

checked 



Marked as PR (cumulative length) 



0010LLST 



0011LLST 



Pseudo 
Register 
Type 1 

Pseudo 
Register 
Type 2 



H 



♦Internal types processed during second pass. 

#Refer to "RLD Input Record (card image) " and "RLD data" (load module) in Section 7: 
Appendix. 
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END Processing 

When an END statement or the end of an 
input load module is detected r END proces- 
sing is required. The functions of END 
processing include: 

• Reset tables (such as the renumbering 
table) that were involved in the pro- 
cessing of the input module. 

• Process entry point information. 

• Delete any CESD lines marked CHAIN or 
DELETE, and keep track of deleted 
lines. 

• Enters in the CESD the length of a con- 
trol section for which no length was 
specified in the ESD item (if the 
length is contained on the end 
statement) . 

Include Processing 

Include processing is required when: 

1 . The control statement scanner has 
detected an INCLUDE statement and the 
include statement processor has built 
an include chain. 

2. End-of -input has been detected , and 
the "more includes" indicator in the 
all purpose table is on. 

Include processing consists of prepara- 
tory functions (OPEN, BLDL, FIND) required 
before the module to be included can be 
read. 

• An input pointer to the library read 
block is set. 

• The SYSLIB DCB is closed (unless it is 
open for a partitioned data set cur- 
rently being used) • 

• Each entry in the include chain is 
examined sequentially. 

SEQUENTIAL DATA SETS : If an include chain 
entry specifies a sequential data set r the 
data set organization field of the DCB is 
changed from partitioned to physical 
sequential, and the ddname field is 
updated. The DCB is then opened, and the 
module is read in. 

PARTITIONED DATA SETS : If an include chain 
entry specifies a member of a partitioned 
data set, the member name is entered into 
the BLDL list , and the next entry is 
examined. If the next entry specifies a 
different data set name, the partitioned 
data set is opened, and a BLDL macro 
instruction is executed for the single 
member name. 



If the next entry specifies another 
member of the same partitioned data set, 
the member name is added to the BLDL list, 
and the next entry in the include chain is 
examined. Member names are added to the 
BLDL list until a different data set name 
is encountered, the BLDL list becomes full, 
or the end of the include chain is reached. 
Since the BLDL list must be in collating 
sequence, each member name is inserted into 
its proper position, moving other entries 
as necessary. Since included modules must 
be read in the order in which they appear 
in the INCLUDE statement (without regard 
for collating sequence) , a separate table, 
indicating the order of processing BLDL 
list entries, is maintained. 

When the BLDL list is completed, the 
partitioned data set is opened and the rec- 
ord format field (RECFM) in the DCB is 
tested to determine if the included modules 
are load modules (U-format) or object 
modules (F-f ormat) . If they are load 
modules, the "load module" indicator is set 
in the APT. This indicator is tested when 
each module is read in. A BLDL macro 
instruction is then executed for the member 
names in the list. The list is then 
examined in the order specified in the 
INCLUDE statement to obtain the attributes 
of each included module (if it is a load 
module) ; the attributes of the output load 
module may be "downgraded" accordingly in 
the APT. 

If the BLDL macro instruction was suc- 
cessful for a particular member, the member 
is read in. The FIND macro instruction and 
the directory entry obtained from BLDL are 
used to set a pointer in the DCB to the 
first record of the member. If the BLDL 
was not successful for a particular member, 
a diagnostic message is printed. 

Note : If a nested INCLUDE statement is 
encountered, it is processed immediately, 
without attempting to construct a multiple 
BLDL list. 

An example of include processing is 
given in Figure 20. The input pointer is 
set to the address of the library read 
block. The address of the current include 
item is contained in the all purpose table. 

Assuming that no includes have yet been 
processed, A will be the first item 
examined. The subtype 'DO' indicates that 
A is a member of a partitioned data set, so 
A will be entered into the BLDL list. The 
pointer 000D refers to the data set 
DATASETX. The next item in the include 
chain, B, is also a member of DATASETX, so 
it is added to the BLDL list. The next 
item in the chain, M, is a sequential data 
set (subtype CO) , so the BLDL list is com- 
pleted with two entries (A and B) . Assum- 



38 



ing that DATASETX is not currently open and 
the SYSLIB DCB is not opened for another 
data set, the SYSLIB DCB is opened for 
DATASETX. (The RECFM field of the data set 
DSCB is merged into the DCB.) Assuming 
that the RECFM field indicates U-format, a 
load module indicator is set in the all 
purpose table r and a pointer to the load 
module buffer is placed in the library read 
block. The attributes of A and B are 
obtained, using BLDL, and the attributes 
specified on the EXEC statement are updated 
accordingly. (The attributes of the output 
load module may be downgraded as a result.) 
A pointer in the DCB is then set to the 
first record of member A, using the FIND 
macro instruction , and the "include 
initiated" indicator is set in the all pur- 
pose table. 

Member A is read using the input pointer 
and library read block. Module A is then 
processed. When the end of module A is 



reached r item A is deleted from the chain 
and the CESD line is marked w null. w Member 
B is then read and processed. 

When the end of module B is reached, 
item B is deleted from the chain, the CESD 
line is marked "null/ and the remainder of 
the chain is processed. 

Automatic Library Call Processing 

Automatic library call processing is 
required: 

• At the end of SYSLIN input when unre- 
solved ERs still exist, and the NCAL 
option was not specified. 

• When a NAME statement has been detected 

(provided that the NCAL option was not 
specified and no more includes are to 
be processed) . 
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Figure 20. Include Processing 
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Automatic library call processing con- 
sists of two series of CESD scans. The 
first series of scans operates on unre- 
solved ERs specified on LIBRARY statements. 
It finds the first ddname that contains a 
pointer in the chain pointer field (bytes 
14 and 15) . Such an entry is the first 
item in a chain of members associated with 
this ddname; there is a distinct chain for 
each ddname that was specified on a LIBRARY 
statement. Chained member names for a par- 
ticular ddname are entered into a BLDL list 
which is processed as previously described 
under the heading "Include Processing." 

The scan of the CESD continues until all 
ddname chains have been processed. A 
second scan of the CESD then searches for 
external references not specified on 
LIBRARY statements and attempts to resolve 
them by calling members of the same name 
from SYSLIB. 1 

An example of automatic library call 
processing is given in Figure 21. Diagram 
A shows two library chains that were built 
in the CESD by the library statement pro- 
cessor. In diagram B, an SD item for JOE 
has been entered into the CESD, resolving 
the reference to JOE. (JOE was removed 
from the chain by ESD processing, and the 
LIB1 chain ID now points to the line con- 
taining TOM.) Automatic library call pro- 
cessing operates on the library chains, as 
modified by ESD processing (diagram B) . 

In the first series of scans, the CESD 
is searched for a ddname (type 02, subtype 
BO) with a chain pointer. The ddname item 
LIB1 is found; its chain ID points to TOM. 
Because TOM is unmatched (subtype 02) it is 
not called and since TOM is the last item 
in the chain (0 in the chain ID field) , the 
scan is resumed for another ddname with a 
chain pointer. LIB2 is found; its chain ID 
points to SAM. No call is issued for SAM, 
since it is unmatched. The chain ID of SAM 
points to PETE, which is matched (indicat- 
ing that PETE is an external reference, and 
not just an operand of a LIBRARY state- 
ment) . PETE is entered into the BLDL list; 
since PETE is the last item in the chain, 
the list is completed with one entry. 

LIB2 is opened and the BLDL macro 
instruction is used to obtain the attri- 
butes of PETE (the attributes of PETE are 
not obtained if the format is F) . A "BLDL 
attempted" indicator is set for the CESD 
entry for PETE so that no other search for 
PETE will be made in the event of an unsuc- 



1 SYSLIB is the standard library whenever 
the linkage editor is executed as a job 
step. If another program LINKs to the 
linkage editor, the ddname of the standard 
library is passed in a parameter list. 



cessful BLDL or non- resolution of the ER 
for PETE by the member PETE. The FIND 
macro instruction is used to set a pointer 
in the SYSLIB DCB to the member PETE; PETE 
is then read in. 

When processing for PETE is completed, 
the scan for ddnames resumes at the begin- 
ning of the CESD, rather than at the CESD 
line where the scan was interrupted, 
because additional ddname items may have 
been entered at any available line in the 
CESD. (Object modules with additional 
LIBRARY statements may have been read in.) 
When the last line of the CESD is reached 
the second series of scans is begun. 
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During the second series of scans, the 
CESD is searched for "unmarked" external 
references (type "02*, subtype ' 00') . 
These are ER items not specified on LIBRARY 
statements. In diagram B, the scan finds 
SIMPLE. Assuming that SYSLIB is the ddname 
for the standard library, SIMPLE is called 
from SYSLIB in the same way that PETE was 
called from LIB2. Every time automatic 
library call processing is resumed after a 
module is read, the second series of scans 
resumes at the beginning of the CESD 
(because ER items from a library member may 
have been entered in any available CESD 
line) . 

When the second series of scans is 
finished, input processing is complete. 
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INTERMEDIATE PROCESSING 

When all input processing is completed, 
the second phase of Linkage Editor F 
(intermediate processing) begins operation. 
The two major functions of the second phase 
are address assignment and intermediate 
output. 



CSECT. The "processed" bit must be 
reset to before address assignment 
processing is terminated. C SECTS that 
do not contain text have no entries in 
the text I/O table. After processing 
all CSECTs with text, addresses are 
assigned to CSECTs without text by 
referring to the CESD. 



ADDRESS ASSIGNMENT (IEWLMADA) 

At the conclusion of input processing, 
address assignment processing is required. 
(See Diagram C1.) Address assignment 
includes the following operations: 



• CESD entries are deleted for ER items 
marked included, called, ddname, or 
overlay in the subtype field. These 
lines are marked "null" and are deleted 
if the module is processed again in a 
subsequent execution of the linkage 
editor. 



• Each segment is considered to be at a 
zero origin. The temporary starting 
address of each control section is com- 
puted with respect to its location in 
the segment, relative to the zero ori- 
gin (plus any adjustments for boundary 
alignment) . These addresses are tem- 
porary because the starting addresses 
of the segments must later be relocated 
with respect to their positions in the 
overlay tree. If the program is not in 
overlay (consists of a single segment) 
the addresses are final , because no 
further relocation by address assign- 
ment is necessary. 



• Compute, for programs in overlay, the 
size of SEGTAB 1 enter the size in the 
all purpose table, and place a private 
code delete entry for the SEGTAB in the 
CESD. The PC-delete type entry is 
deleted from the module if it is pro- 
cessed again by linkage editor. (Dia- 
gram C1, Area A) 



• Compute the temporary relocation con- 
stant for each control section (the 
difference between the temporary linked 
address and the assigned address in the 
input) and place it in the relocation 
constant table (RCT) (Area D) . If the 
program is not in overlay , these are 
the final relocation constants (rela- 
tive relocation factors) . 



• Enter segment numbers for label 

references in the CESD. If the program 
is in overlay, the calls list (built 
during RLD processing) is also scanned, 
and pointers from one chain of calls to 
the next chain are entered; (Area B) 
the number of ENTAB bytes 2 for each 
segment is determined; and a PC- delete 
type entry is placed in the CESD for 
each ENTAB. (Refer to "ENTAB Size 
Determination. ") 



• Assign temporary linked addresses to 
SD-, PC-, and CM-type entries in the 
CESD (Area C) . CSECTs are processed 
according to the order of input deter- 
mined by scanning entries in the text 
I/O table. Since an ID can appear more 
than once in the text I/O table, a 
"processed" bit (bit 4 of the "type" 
byte) is set in the CESD entry to indi- 
cate that a temporary linked address 
has been assigned to the associated 



i SEGTAB size = 24 + (4 x number of 

segments) . 
2 ENTAB size = 12 + (12 x number of unique 

downward calls per segment) . 



• Accumulate the length of each segment 
in the leftmost three bytes of an entry 
in the segment length table (SEGLGTH) . 
The boundary alignment factor of the 
first control section in the segment is 
placed in the fourth byte of the entry. 



• Determine the address of each PR-type 
entry in the CESD, using the total 
length of all PRs previously encoun- 
tered, plus the boundary alignment fac- 
tor. This address is placed in the 
CESD entry for the PR. The length of 
this PR is then added to the cumulative 
PR length. 



• Process the SEGLGTH table (if the pro- 
gram is in overlay) to determine the 
starting address of each segment, rela- 
tive to the beginning of the program. 
(Area E) SEGTA1 is checked to find the 
proper location of each segment in the 
tree. SEGLGTH at this time contains 
the length of each segment. To deter- 
mine the starting address of a segment, 
the length of all previous segments in 
the same path are added, together with 
any adjustments for boundary alignment. 
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(Boundary alignment adjustment is 
determined by the last three bits of 
the address of the first control sec- 
tion in a segment.) This sum r minus 
the boundary alignment factor for the 
segment, is the segment relocation con- 
stant (SRC) . The SRC is then placed in 
the rightmost three bytes of the 
SEGLGTH table. The sum of the SRC, the 
boundary alignment factor, and the seg- 
ment length is placed in the leftmost 
three bytes of the SEGLGTH table entry 
for the segment. It is the length of 
the path of the segment (including the 
segment itself) . At the completion of 
this process, the entry in SEGLGTH for 
each segment contains the cumulative 
length of its path; the longest of 
these lengths is the program length. 

• Perform a second scan of the CESD if 
the program is in overlay. The segment 
relocation constant in the SEGLGTH 
table is added to the temporary linked 
address in the CESD entry for the con- 
trol section; this sum is the final 
linked address . The SRC is also added 
to the temporary relocation constant in 
the relocation constant table; this sum 
is the final relocation constant for 
the control section. 

• Make a final scan of the CESD to assign 
a final linked address to each label 
reference. 

The CESD entry for each LR contains a 
reference to the control section in 
which it resides. The relocation con- 
stant for that control section is 
located in the RCT and is added to the 
temporary linked address in the CESD 
entry for the LR. This sum, the final 
linked address for the LR, is placed in 
the CESD. 

• Mark the program as not executable if 
there are still unresolved external 
references and if neither the no call 

(NCAL) option nor the LET option has 
been specified. 

• Build the alias table and compute an 
entry point for the program. (Refer to 
"Entry Processing.") 

ENTAB Size Determination 

ENTAB size determination consists of 
computing the size of ENTABs so that the 
size of each segment in an overlay program 
can be determined and relative relocation 
factors can be computed for use by second 
pass processing. The size is determined by 
the number of downward calls, or calls 
across regions, to symbols that are not 
referred to by segments higher in the path 
of the calling segments. 



An example of ENTAB size determination 
is given in Figure 23. The overlay tree 
structure shown in the illustration con- 
sists of nine segments residing in two 
regions; all references between segments 
are made using V-type address constants. 
Functions of ENTAB size determination are: 

• Scanning the CESD for LR-type entries 
and entering their segment numbers. In 
Figure 23, item 6 is an LR item; its 
ID/length field points to the CESD 
entry for the control section in which 
it resides (line 3) . The segment num- 
ber contained in line 3 (segment number 
3) is entered in the segment number 
field of the LR item. 

• Scanning the calls list, inserting 
chaining values that point from one 
group of R and P pointers to the next. 

• Scanning the calls list, for each seg- 
ment (starting with segment 1) , find 
symbols referred to by that segment. 
For each reference found , the type of 
call (upward, downward, or exclusive) 
is determined. If an ENTAB is required 
for the segment, its size is determined 
and a PC-delete type entry for the 
ENTAB is made in the CESD. Referring 
to Figure 23, the segments are pro- 
cessed in the following manner: 

1. The calls list is scanned for P 
pointers that refer to control 
sections in segment 1. If one is 
found, the associated R pointers 
(which refer to referenced sym- 
bols) are examined to determine 
the segment in which each 
referenced symbol resides. In 
Figure 23, the fifth P pointer 
refers to line 7 of the CESD, 
which contains an SD-type entry 
for a control section in segment 
1. The associated R pointers 
refer to line 6 (symbol B in seg- 
ment 3) and line 4 (symbol C in 
segment 5) . For each reference, 
the type of call (upward, down- 
ward, or exclusive) is determined, 
using SEGTA1 and the segment num- 
bers of the calling and called 
segments. In Figure 23, SEGTA1 
indicates that segment 1 is in the 
path of segments 3 and 5; there- 
fore, the calls from segment 1 to 
B and C are downward calls. This 
is noted in the downward calls 
list by entering segment number 1 
in the lines referred to by the R 
pointer (lines 6 and 4) . Since 
segment 1 is the root segment, it 
must have an ENTAB; the size of 
the ENTAB is determined and a PC- 
delete type entry for the ENTAB is 
created in the CESD. 
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When the scan for segment 1 is 
completed, the calls list is 
scanned for P pointers that refer 
to segment 2. In Figure 23 , the 
third P pointer in the calls list 
refers to CESD line 6, which con- 
tains segment number 3. This 
indicates (via SEGTA1) a downward 
call from segment 2 to symbol B in 
segment 3. In this case, however, 
no entry is made in the downward 
calls list because it indicates a 
call to B in segment 3 from seg- 
ment 1, which is higher in the 
path of the calling segment {seg- 
ment 2) . No ENTAB is required for 
segment 2 because the reference to 
symbol B in segment 2 can be 
resolved through the ENTAB entry 
in segment 1 . 

The calls list is scanned for P 
pointers that refer to segment 3. 
In Figure 23, the fourth P pointer 
in the calls list refers to CESD 



line 3 (segment 3) . The R pointer 
refers to CESD line 8 (segment 8) . 
SEGTA1 indicates that the call 
from 3 to 8 is downward, across 
regions, and the call is noted in 
the downward calls list. Segment 
3 requires an ENTAB because it 
contains a downward call to a sym- 
bol not referred to by a segment 
in the path of the calling seg- 
ment; the ENTAB size is deter- 
mined, and a PC-delete type entry 
for the ENTAB is created in the 
CESD. 

The calls list is scanned for P 
pointers that refer to segment 4. 
In Figure 23, the first P pointer 
in the calls list refers to CESD 
line 9 (segment 4) . The R point- 
ers refer to line 2 (segment 2) 
and line 8 (segment 8) . SEGTA1 
indicates that the call from 4 to 
2 is upward, while the call from 4 
to 8 is downward across regions. 
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The upward call is ignored because 
the address constant can be 
resolved directly to the 
referenced symbol. The downward 
call from 4 to 8 is noted in the 
downward calls list, replacing the 
previous entry for segment 3 
(because no segment with a segment 
number greater than 4 can have 
segment 3 in its path) . Since an 
ENTAB is required, the size is 
determined and a PC-delete type 
entry is created in the CESD. 

This process continues until all seg- 
ments have been processed. The required 
ENTABs are built during second pass proces- 
sing (Refer to "ENTAB Creation" and "Relo- 
cation of V-Type Address Constants in 
Overlay.") 



Entry Processing 

Entry processing includes the following 
operations : 

• Enters into the alias table any alias 
symbols that were chained together and 
saved in the CESD by the alias state- 
ment processor. Each entry in this 
table consists of an 8-byte symbol 
field and a 2-byte ESDID field. For 
each saved alias symbol, the entry pro- 
cesssor scans the CESD for a matching 
SD-type or LR-type entry. If no match 
is found, a zero is placed in the ESDID 
field of the alias table entry for the 
symbol. If a matching SD or LR entry 
is found, the ESDID of the alias entry 
in the chain is placed in the ESDID 
field of the alias table entry for the 
symbol. (See Figure 24.) The address 
assigned by linkage editor to the 
matching SD or LR and the ESDID of its 
control section are placed in the CESD 
entry for the chained symbol, and the 
type of the chained symbol is changed 
to null. 

• Determines whether the entry point was 
specified as an address on an END 
statement, or as a symbol on an ENTRY 
statement or END statement: 

1 . If the entry point was specified 
as an address on an END statement, 
the assigned address is determined 
by either absolute or relative 
relocation. If the ID on the END 
statement referred to an ER which 
was resolved with an SD or LR, the 
address assigned by the linkage 
editor to the SD or LR is added to 
the address from the END statement 
(absolute relocation) . If the ID 
on the END statement referred 
directly to an SD or PC, the relo- 



cation constant for the SD or PC 
is added to the address from the 
END statement (relative 
relocation) . 

2. If a symbolic entry point was 
specified on an ENTRY statement or 
END statement, the CESD is scanned 
for a matching SD- or LR-type sym- 
bol. The address of the matching 
symbol is used as the entry point. 

3. If no entry point was specified, 
the starting address of the SD- or 
PC- type control section (not 
marked delete) with the lowest 
assigned address is chosen as the 
entry point. The entry point 
associated with the main name (not 
an alias) and all alias entry 
points must be in segment number 
one if the program is in overlay. 



INTERMEDIATE OUTPUT (IEWLMOUT) 

Intermediate output processing includes 
the following operations: 

• Writes out the CESD on SYSLMOD in 
groups of 15 entries per record. 1 (The 
last record may consist of less than 15 
entries.) 

• Builds a half ESP (HESD) , consisting of 
the last eight bytes of each CESD 
entry. (The symbol is deleted from 
each CESD entry to conserve main 
storage space during second pass pro- 
cessing.) The HESD is not complete at 
this time. (The ID of each label 
reference is used in building the 
scatter and translation tables.) 

• Builds and writes out the segment table 

(SEGTAB) , preceded by a control record 
describing it, if the program is in 
overlay. 2 SEGTAB contains information 
required by the overlay supervisor. 

• Builds a scatter table and a transla- 
tion table for a program that is to be 
scatter loaded and writes out scatter/ 
translation records in a form accept- 
able to program fetch at execution 
time. The scatter /translation informa- 
tion is written out on SYSLMOD in 1024- 
byte records. The first four bytes of 
each record are used to identify the 



The CESD and control record are not writ- 
ten out on SYSLMOD if the "not editable" 
attribute is specified. 
2 If it is negative, an indicator is set in 
the HESD to note that it is in complement 
form. 
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Figure 24. Processing of Alias Symbols by the Entry Processor 



records as scatter/translation informa- 
tion. If the length of scatter/ 
translation information is greater than 
1020 bytes , the last 1020 bytes (plus 
four bytes of header information) are 
written out as the first scatter/ 
translation record. The data in the 
last record may be 1020 bytes , or less. 
(See Figure 25.) 

Reads the TXT and RLD note lists into 
main storage if they were placed on 
SYSUT1 during TXT and RLD processing. 
(Each note list may have been written a 
maximum of three times on SYSUT1 for a 
large program. In this case, TTRs 
pointing to the locations of note list 
information are contained in the I/O 
control table.) 



• Determines the control section contain- 
ing the last text in the program (or in 
each segment , if the program is struc- 
tured for overlay) , and the highest 
segment number of the segments that 
contain text. (This information is 
necessary so that second pass proces- 
sing can determine when to set the end- 
of -segment or end-of -module indicator.) 
The highest ESDID is determined by 
scanning the text I/O table for the 
ESDIDs of control sections that contain 
text. This ESDID is entered into the 
high ID (HIID) table along with its 
associated segment number. 

• Determines , via bits in the all purpose 
table (APT) , if the MAP option has been 
specified, or if the XREF option has 
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been specified and all RLDs are in 
storage. If either of these conditions 
exists r the module map and/or the 
cross-reference table are produced. If 
the XREF option is specified and all 
RLDs are not in storage, XREF proces- 
sing will be done as part of final 
processing. 



MAP/XREF Processing 

When MAP/XREF processing is required as 
part of intermediate output processing, a 
table address is obtained from the APT, and 
a table of two-byte entries pointing 
directly to the CESD is constructed. The 
CESD records for the current segment are 
gathered and sorted by address. The module 
map is then printed out; the map lists, in 
ascending order according to their assigned 
origins, all control sections contained in 
the output module and the entry points 
within the control sections. Control sec- 
tions in an overlay output module are 
grouped by segment. 

If XREF processing is done during inter- 
mediate output processing, RLD items are 
incompletely relocated; their addresses are 
relative to the origins of their respective 
CSECTs rather than the origin of the load 
module, and the address of each RLD must be 
added to the linkage editor assigned 
address of its corresponding CSECT before 
the cross-reference table is produced. The 
cross-reference table includes a module map 
and a list of all references within a given 
segment that refer across control section 
boundaries. Each entry in the list con- 
tains the address of the reference, the 
symbol to which it refers, and the name of 
the control section in which the symbol is 
defined. For overlay programs, each item 
in the list also contains the number of the 
segment in which the symbol is defined. 



If the MAP and XREF options are pro- 
cessed during intermediate output proces- 
sing, ALIAS and NAME messages and the diag- 
nostic message directory are printed after 
the module map and cross-reference table. 
If the cross-reference table is produced 
during final processing, the ALIAS and NAME 
messages are printed before the map and 
table, and the diagnostic message directory 
is printed after the map and table. 



SECOND PASS PROCESSING (IEWLMSCD) 

After intermediate processing is com- 
pleted, the third phase of Linkage Editor F 
(second pass processing) begins. (See Dia- 
gram D1.) The major functions of second 
pass processing include: 

• Relocate address constants contained in 
the text. 

• Create control/RLD records. 

• Write TXT and control/RLD records onto 
SYSLM0D in a format that can be loaded 
by program fetch. 

• Create ENTABs and associated RLD items 
for overlay modules. 

Operation Diagram D1 illustrates the func- 
tions of second pass processing. 



SINGLE- PASS PROCESSING: 



"In-core" indica- 



tors in the text I/O table and the RLD note 
list are checked to determine if text and 
RLD records have been written onto SYSUT1 
or have been retained in the text buffer 
and the RLD buffer. If either text or RLD 
records have been retained in storage, 
single-pass processing is in effect for 
that record type. If two-pass processing 
is in effect , the records are read into the 
buffers from SYSUT1. 
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ORDERING OF TEXT : In two-pass processing, 
the ID sequence in the text I/O table is 
used to determine the order in which CSECTs 
are to be read into the second pass text 
buffer (which is physically the same 
storage area as the input text buffer) . 
The text I/O table entry for each ID and 
the corresponding text note list entry are 
used to locate text on SYSUT1. (See Dia- 
gram D1, Area A.) Text is read into the 
buffer a multiplicity at a time, using the 
displacement field in the text note list to 
determine where within the buffer the text 
must be placed. Information about the text 
is entered into the second pass text con- 
trol table , which is used to control subse- 
quent processing of the text (area B) . 



SECOND PASS RLD BUFFERS ; When the required 
text is in the text buffer r the correspond- 
ing RLDs are read into the RLD input buff- 
er, using the RLD note list to locate the 
RLD records (area C) . The RLD input buffer 
can contain two RLD records from SYSUT1; 
for each RLD input buffer area, an RLD 
input control block is maintained (area D) . 
The RLD output buffer is 76 8 bytes long and 
is divided into three buffer areas (the 
maximum RLD output record is 256 bytes 
long) ; for each RLD output buffer area, an 
RLD output control block is maintained 

(area F) . While text is being relocated, 
the control record for that portion of text 
occupies one of the output buffers; the 
other two output buffers contain the relo- 
cated RLDs for the text being processed 

(area E) . If the relocated RLDs exceed two 
buffers, the control record is written onto 
SYSLMOD; relocated RLDs may then be moved 
into the third output buffer. 

When all three RLD output buffers and 
the RLD input buffers are filled and addi- 
tional RLDs are required to relocate the 
text currently being processed, the con- 
tents of the output buffer must be written 
out. However, to maintain the required 
TXT/RLD sequence in the output module (area 
G) , the associated text must precede the 
RLD record. Space for the text is reserved 
in the output module by writing the incom- 
pletely relocated text; the contents of the 
RLD output buffer may then be written, and 
processing can continue. When the text is 
completely relocated, it is written over 
the space reserved for it, using XDAP 
("execute direct-access program") . 



GROUPING SYSLMOD OUTPUT : As many CSECTs as 
will completely fit in one SYSLMOD record 
(up to a maximum of 60) are grouped and 
written as one record. RLDs are grouped to 
correspond to the grouping of their asso- 
ciated text. If the overlay option is 
specified, only CSECTs belonging to the 
same segment will be grouped. 



If a CSECT is larger than the SYSLMOD 
record size, the CSECT is divided in multi- 
plicities, each multiplicity being equal to 
the SYSLMOD record size. (The length of 
the last multiplicity may be less than the 
SYSLMOD record size.) Each multiplicity is 
written as a record, followed by RLDs asso- 
ciated with only that multiplicity. 

Note : If the downward compatible option 
(DC) or the scatter format option (SCTR) is 
specified, CSECTs will not be grouped. 



END OF MODULE : When control sections for 
all segments of the output module have been 
processed (determined via the "high ID" 
indicator in the HESD type field and the 
"last segment with text" field in the all 
purpose table) , indicators are set in the 
last control/RLD record to mark it as the 
end of the module. The control/RLD record 
is written out on SYSLMOD, and second pass 
processing is completed. 



Note : If the output load module is to be 
structured for overlay, a list of relative 
track addresses (TTR list) is created to be 
used by program fetch when it loads the 
segments into main storage for execution. 
The TTR list contains one entry for each 
segment in the overlay load module. Each 
entry contains the relative track address 
of the first record (control record) of a 
segment, except for the first segment, 
which contains the relative track address 
of the first text record. A PC- type con- 
trol section, which contains ENTAB entries 
in each segment where the text requires 
them, and the RLD records required by pro- 
gram fetch to relocate address constants 
contained in the ENTABs, are also created. 



RELOCATION OF ADDRESS CONSTANTS 

There are two types of relocatable 
address constants: 

1. Eranch type, such as DC V (X) . 

2. Non-branch type, such as DC A (X) . 

The value of a branch type or non-branch 
type address constant depends on a symbol 
in the CESD. To adjust an address constant 
to its proper value in the output load 
module, the linkage editor uses an absolute 
or relative relocation factor. The abso- 
lute relocation factor is the address 
assigned by linkage editor to the symbol on 
which the value of the address constant 
depends. The relative relocation factor is 
the difference between the address assigned 
to the symbol by linkage editor and the 
address of the symbol in the input module. 
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The relative relocation factor may be posi- 
tive or negative. The absolute and rela- 
tive relocation factor of each symbol in 
the CESD is computed during address assign- 
ment and is saved in the half ESD (HESD) . 



Relocation of Non-Branch Type (A-Type) 
Address Constants 



A relative relocation factor is used for 
a non-branch type address constant if the 
symbol on which its value depends is in the 
same input module as the control section 
that contains the address constant. (The 
address constant and the symbol it refers 
to were assembled or compiled together, or 
were previously processed together by link- 
age editor.) An example of relative relo- 
cation of non- branch type address constants 
is shown in Figure 27. Since the address 
of DICK is known, the language translator 
places it in the value of the address con- 
stant. DICK is a known value prior to 
linkage editor processing (not an external 
reference in the input) ; therefore, a rela- 
tive relocation factor (+1000) is used to 
relocate DICK during linkage editor 
processing. 



reference.) An example of absolute reloca- 
tion of a non-branch type address constant 
is shown in Figure 28. In this example, 
the value of SAM is unknown when input 
module 1 is processed by the language 
translator; therefore, zeros are placed in 
the value of the address constant. During 
second pass processing, the absolute relo- 
cation factor (the linkage-editor-assigned 
address) is used to relocate the address 
constant. 



Figure 29 shows the use of both a rela- 
tive relocation factor and an absolute 
relocation factor in relocating a symbol. 
Two input modules are to be processed by 
linkage editor. Input module 1 contains a 
non-branch type address constant whose 
value depends on the symbol PETE; PETE is 
an external reference in the same module. 
The language translator has assigned a 
value of +10 to the address constant. The 
R pointer of the RLD item refers to the ER 
entry for PETE in the ESD; this entry con- 
tains zeros in the origin and length 
fields. The P pointer refers to the SD 
entry for the control section that contains 
the address constant. 



An absolute relocation factor is used 
for a non-branch type address constant if 
the symbol referred to by the address con- 
stant does not have a defined value within 
the same input module. (The R pointer of 
the RLD item refers to an external 



Input module 2 contains two control sec- 
tions, BOB and PETE. BOB contains a non- 
branch type address constant whose value 
depends on PETE; since PETE has a defined 
value (300) in the same module, the lan- 
guage translator has used that value to 
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Figure 27. Non-Branch Type Address Constants - Relative Relocation 
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t Actual address of SAM in the output module 
(0501) is added to value of address constant. 
(Note that the relative relocation factor of 
SAM is +251.) 



Figure 28. Non-Branch Type Address Constants - Absolute Relocation 



compute the value of the address constant 
(PETE+10=310) . The R pointer of the RLD 
item refers to the SD entry for PETE in the 
ESD; the P pointer refers to the SD entry 
for BOB (the control section that contains 
the address constant) . 

During linkage editor processing , the ER 
and SD entries for PETE are merged into one 
CESD entry; the R pointers of both RLD 
items in the output module will refer to 
that entry. The RLD P pointer for the 
address constant in control section BILL 
will refer to the SD entry for BILL; the P 
pointer for the other address constant will 
refer to the SD entry for BOB. In the out- 
put module , both address constants will 
contain the same value. Since the R point- 
er of the RLD item in input module 1 refers 
to an ER-type ESD entry in that module , it 
is marked for absolute relocation; the 
absolute relocation factor for PETE (+500) 
is added to the value (+10) assigned by the 
language translator. Since the R pointer 
of the RLD item in input module 2 refers to 
an SD-type ESD entry in module 2, it is 
marked for relative relocation; therefore, 
during relocation the relative relocation 
factor for PETE (+200) is added to the 
value (+310) assigned by the language 
translator. The relocated value for both 
address constants is 510. 



Relocation of all non-branch type 
address constants requires an addition or 
subtraction of the relocation factor to or 
from the value of the address constant in 
the text of the input module. (Addition or 
subtraction is specified in the flag field 
of the RLD item for the address constant.) 

DELINKING NON-BRANCH TYPE ADDRESS CON- 



STANTS: 



A relative relocation factor can- 



not be used to relocate an A-type address 
constant that refers to a symbol in a con- 
trol section being replaced. Since the 
address constant has been previously relo- 
cated (by a language translator or by link- 
age editor) , it contains the value of a 
symbol being replaced; therefore r the value 
of that symbol must be subtracted from the 
value of the address constant. This pro- 
cess is called delinking . In delinking r an 
address constant is reduced to the value it 
would have contained if it referred to an 
external reference in the input module. 
After delinking, the address constant con- 
tains the value required for proper reloca- 
tion , should the replaced symbol appear 
later in the input , in another control sec- 
tion. Delinked address constants are 
treated like address constants whose values 
depend on external references. (Absolute 
relocation factors are used in relocating 
them.) 
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Figure 29. Non-Branch Type Address Constants - Absolute and Relative Relocation 



Delinking of an A-type address constant 
is shown in Figure 30. Input load modules 
A and B both contain control section SAM. 
During linkage editor processing , the first 
occurrence of control section SAM is 
accepted, while the second occurrence is 
deleted through automatic control section 
replacement. 



Control section BILL in module B con- 
tains a reference to symbol JOHN in control 
section SAM. Since SAM in module B will be 
deleted, the address constant A (JOHN+50) in 
module B must be delinked so that it may be 
properly resolved with the symbol JOHN in 
module A. In delinking, the old value of 
JOHN is subtracted from the value of the 
address constant in BILL (120-70=50) . The 
absolute relocation factor for JOHN (1850) 
is then added to the delinked value of JOHN 
(50+1850=1900) . 



DELINKING COMMON CONTROL SECTIONS ; Common 
control sections (either blank common or 
named common) must be "delinked" by linkage 
editor. All references to common control 
sections are made by means of non-branch 
type address constants. 



If the assigned address of a common con- 
trol section in the input to linkage editor 
is not zero, all such references must be 
delinked. Delinking is necessary because 
during linkage editor processing all blank 
common control sections are collected into 
a single control section. All identically 
named common control sections are gathered 
into individual control sections; 
references to them from different input 
modules must be delinked so that they can 
be properly relocated with respect to the 
locations of the common control sections in 
the output module. 
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Notes: 

• A relative relocation factor is used to relocate the address constant A(JOHN+50) in 
control section JOE, because JOE and SAM are in the same module. 
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Figure 30. Example of Delinking 



Delinking adjusts the value of each 
address constant in a common control sec- 
tion so that it contains its correct dis- 
placement from the control section origin. 
The values of such address constants are 
then relocated so that they refer to link- 
age editor assigned addresses , using abso- 
lute relocation factors. 

Relocation of Branch Type (V-Type) Address 
Constants 

Only absolute relocation factors are 
used to relocate branch type address con- 
stants. Since a displacement is not 
allowed in the value of a V-type address 
constant , the absolute relocation factor is 
inserted in the value field during reloca- 
tion. (It is not added to or subtracted 
from the value assigned by the language 
translator, as described for A- type address 
constants.) Because the value of a V-type 
address constant is inserted, delinking is 



never necessary for such address constants. 
Relocation of V-type address constants in 
an overlay structure is discussed in the 
following paragraph. 

RELOCATION OF V-TYPE ADDRESS CONSTANTS IN 
OVERLAY ; If the output of linkage editor 
is to be an overlay load module, a 4-byte 1 
branch type address constant in the path of 
the symbol it refers to (but in a different 
segment) , or in a different region, will be 
relocated in a special manner. The value 



11 Any address constant must be four bytes 
because the high-order byte is used by the 
overlay supervisor during execution. The 
number of the segment containing the 
address constant will be placed in the 
high-order byte of any V-type address con- 
stant resolved to an ENTAB entry. (The 
high-order byte must be zero if it is not 
resolved to ENTAB entry.) 
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field of the address constant will contain 
the address of an ENTAB entry. The ENTAB 
entry will contain the address assigned by 
linkage editor to the symbol referred to by 
the value of the address constant. An 
ENTAB entry is created for each V-type 
address constant that is in the path of the 
symbol it refers to (but is not in the same 
segment) , or located in a different region , 
provided that the symbol is not referred to 
in a segment higher in the path of the 
calling segment. (Such address constants 
are resolved so that they refer to the 
ENTAB entry previously created for the sym- 
bol in the higher segment.) ENTAB entries 
are not created for address constants that 
refer to symbols higher in the path. 
Whenever an ENTAB entry is created, it is 
noted in an entry list ; each item in the 
entry list contains the entry number of the 
referenced symbol in the HESD, the segment 
number of the calling segment, and the 
address assigned to the ENTAB entry by lin- 
kage editor. The ENTAB creation routine 
uses the entry list to build ENTAB entries. 
(Refer to "ENTAB Creation.") 

When second pass processing begins to 
process a segment, the entry list is modi- 
fied so that it contains only entries for 
segments higher in the path of the current 
segment. (In Figure 31 segment 4 is being 
processed; the entry for segment 3 is 
removed since it is not higher in the path 
of 4.) 
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Figure 31. Entry List Processing 

During relocation, each V-type address 
constant is examined to determine if an 
ENTAB entry must be created for it. The R 
pointer of the RLD item for the address 
constant is used to find the associated 
HESD entry; this entry contains the segment 
number of the symbol referred to by the 
address constant. The relationship of this 
segment to the current segment is then 
determined, using SEGTA1. Depending on the 
relationship in SEGTA1, the address con- 
stant is relocated in one of three ways: 

1 . If the segment that contains the sym- 
bol is higher in the path of the cur- 



rent segment, the call is upward and 
the address constant is resolved 
directly. (The absolute relocation 
factor of the symbol is inserted in 
the value of the address constant.) 

2. If the current segment is higher in 
the path of the segment that contains 
the symbol, the call is downward. The 
entry list is checked to determine if 
an ENTAB entry was previously created 
for the symbol in this segment, or in 
a segment higher in the path of this 
segment. If an ENTAS entry for the 
symbol exists, its address (contained 
in the entry list) is placed in the 
value field of the address constant. 
If no ENTAB entry exists for the sym- 
bol, a new entry is placed in the 
entry list, and an FNTAB entry will be 
created by the ENTAB creation routine. 

(Refer to "ENTAB Creation.") The ENTAB 
entry will contain the address 
assigned to the symbol by linkage edi- 
tor, and the address of the ENTAB 
entry will be placed in the value of 
the address constant and in the entry 
list item. 

3. If neither of the two segments is 
higher in the path of the other, the 
call is either exclusive or across 
regions. If the two segments are in 
different regions, and no ENTAB entry 
already exists for the symbol in the 
entry list, an ENTAB entry will be 
created and an entry is made in the 
entry list; the value field of the 
address constant is relocated to the 
address of the ENTAB entry, which in 
turn contains the relocated address of 
the symbol. If the two segments are 
in the same region, the call is exclu- 
sive. If there is an entry in the 
entry list for the symbol, the address 
constant is resolved through its ENTAB 
entry; if there is no entry for the 
symbol in the entry list, the call is 
an invalid exclusive call and the 
address constant is resolved directly 
to the symbol. (This usually leads to 
incorrect results during execution of 
the module.) 

ENTAB Creation 

The ENTAB creation routine uses the size 
field in the HESD to determine the number 
of ENTAB entries to be created for a given 
segment. The entry list is scanned for all 
entries that were created for the current 
segment; each of these entries contains the 
HESD entry number for the corresponding 
symbol. The value and segment number of 
the symbol are obtained from the HESD and 
are entered into the ENTAB entry, along 
with standard information shown in the 
Appendix. 
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ENTAB creation is shown in Figure 32. 
The V-type address constants referring to 
SAM and BILL in segment 1 meet the require- 
ments for building ENTAB entries. The ESD 
and RLD input to the second pass processor, 
and the overlay tree structure are shown in 
diagram A. During relocation, entries are 
created for SAM and BILL in the entry list 
(see diagram B) ; each entry contains the 
address of the ENTAB entry created for the 
address constant. 

In segment 1, location 136 of control 
section JOE contained a call to control 
section SAM before relocation. After relo- 
cation, location 136 contains the address 
of the ENTAB entry for SAM, and the high- 
order byte of the address constant contains 
the segment number of the calling segment. 
An ENTAB entry is created, in like manner, 
for BILL in segment 1 . 

In segment 2, the address constant 
referring to BILL does not meet the 
requirements for building an ENTAB entry. 
(It is not in the path of the segment con- 
taining the symbol.) Therefore, no ENTAB 
is created in segment 2. The call for seg- 
ment 2 to BILL in segment 3 is an exclusive 
call. Since a call to the same symbol 
appears in a higher segment common to 2 and 
3 (segment 1) the address constant may 
refer to the ENTAB entry for BILL in seg- 
ment 1 . (This is determined by scanning 
the entry list for the HESD entry corre- 
sponding to the symbol BILL.) If a call to 
BILL was not contained in a common segment, 
the address constant DC V (BILL) in segment 
2 would be resolved using the value 
assigned by linkage editor to the symbol 
BILL, which results in an error. 

In segment 3, the address constant is an 
upward call and is resolved directly. 

Relocation Routine 

The relocation of address constants is 
performed by the relocation routine; the 
routine operates on the following input 
data: 

• The address of the RLD input buffers 
which contain RLD records. 

• The address of the RLD notelist entry 
for the RLDs being processed. 

• The address of the next available entry 
in the RLD output buffer. 

• The buffer relocation constant (BRC) 
where: 

BRC = starting buffer address of cur- 
rent text + relative relocation 
constant of current control section 
- address assigned to current con- 
trol section by linkage editor - 
multiplicity size X current multip- 
licity number 



The relocation routine operates in the 
following manner: 

1 . The size of the RLD set 1 and the dis- 
placement from the beginning of the 
buffer is determined from the RLD note 
list. 

2. Each RLD item in the current RLD set 
is scanned to determine if: 

a. It describes an address constant 
for the current text being pro- 
cessed (BRC + address contained in 
RLD address field falls within the 
text buffer boundaries of the cur- 
rent text.) 

b. The address constant is either a 
valid 2-, 3-, or 4 -byte address 
constant. (The only valid 2-byte 
address constants are pseudo 
register type.) 

3. Each address constant whose RLD meets 
the above requirements is moved from 
the text into a computation area. The 
address constant associated with the 
RLD item is then relocated according 
to the information in the flag field 
of the RLD item (refer to Table 7) . 
The relocated address constant is then 
placed back into the text. 

4. The RLD address field is updated using 
the relative relocation factor for the 
control section being processed. (The 
control section referred to by the P 
pointer of the RLD item) . 

5. The RLD is moved into the RLD output 
buffer if space is available. If 
space is not available, the contents 
of the RLD output buffer are written 
out on SYSLMOD. 2 

6. Steps 2 through 5 are repeated until 
all RLD items have been scanned in the 
RLD set being processed. The multip- 
licity number in the RLD notelist is 
updated if unprocessed RLDs remain in 
the set. 

7. If there are more RLD sets in the 
input buffer to be processed, the 
address of the next record is deter- 
mined and steps 1 through 6 are 
performed. 



i An RLD set is a group of RLDs referred to 
by a particular RLD notelist entry. 

2 If the XDAP indicator is off, a dummy text 
record is written out before the contents 
of the RLD output buffer are placed on 
SYSLMOD. If the XDAP indicator is on, a 
dummy write of the text record is not 
required, because text is already written. 
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Segment 1 after processing by Second Pass Processor. 



JOE 

01000236 
DC ViSAMJ 

01000248 

dc vjpy-ttr 


47FF 0024 


00000 272 


02 


000000 


47FF 0012 


00000 272 


03 


000000 


Standard Last ENTAB Entry 



ENTAB 



Diagram D. 



272 



752 



Segment 2 after processing by Second Pass Processor. 
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Figure 32. ENTAB Creation 
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Table 7. Relationship of RLD Flag Field to Relocation 



I— 



Flag | 

I +- 

0000LLST I Absolute 



I- 



Input 



Type 



Action 
Performed 



Absolute relocation factor is 
added to value of address con- 
stant 



Output 

Flag | Type 

H 



0000LLST 



A-type 



-H 



0001LLST 



Branch 



Absolute relocation factor is 
inserted into value of address 
constant 



0001LLST 



V-type 



_ + 

PR- displacement 
value 
(PR type 1) 

PR-cumulative 
displacement 
value 
(PR type 2) 



1 0LLST 



0011LLST 



Absolute relocation factor is 
inserted into value of address 
constant 



0010LLST 






PR length from All Purpose 
Table is inserted into value of 
address constant 



0011LLST 



PR-displacement 
value 

PR- cumulative 

displacement 

value 



H 



1000LLST 



Relative 



Relative relocation factor is 
added to value of address 
constant 



0000LLST 



A-type 



h 



-L_ 



Notes: 



If S (sign) in LLST is 1, subtraction is performed, rather than addition. 

In delink type r the delink value is added or subtracted according to the opposite 

of the sign; the absolute relocation factor is added to or subtracted from the 

address constant according to the indicated sign. 

If an RLD item refers to an undefined symbol, the associated address constant is 

not relocated. (It may have been delinked.) The high-order bit of the RLD item 

flag field is set to one (1000LLST for an A-type constant, 1001LLST for a V-type 

constant) and no relocation will be performed when the module is loaded into main 

storage for execution. 

Delinking is noted in the high-order bit of the P pointer. 



Note: 



In order to minimize the number of 



times that RLD records are read from SYS- 
UT1, RLD records for a control section are 
held in the input RLD buffer, when possi- 
ble, until all RLD records in the buffer 
have been processed (because each RLD rec- 
ord may pertain to many multiplicities of 
text) . After each set of RLDs is scanned, 
the multiplicity number in the RLD note 
list is updated to reflect the multiplicity 
of the remaining unprocessed RLD records in 
the set. An RLD record is removed from the 
buffer when: 

1 . All RLD items in the record have been 
processed. (Their associated address 
constants have been relocated.) 

2. Another RLD record must be read into 
the buffer and space is not available. 



When all records in the input RLD buffer 
have been scanned, the relocation routine 
determines if more RLD records for the cur- 
rent multiplicity of text are to be read 



in. (The read RLD routine sets an indica- 
tor when it encounters such a record but 
cannot read it into the buffer because the 
buffer is full.) When both buffers are 
full, the second buffer is freed, and the 
corresponding RLD note list entries are 
marked "out- of -core." The records to be 
read in are then placed in the second RLD 
buffer; these records are processed in the 
same manner as those already residing in 
the first buffer. This process is repeated 
until all records that contain RLD items 
pertaining to the current multiplicity of 
text have been scanned and processed. 



When all RLDs in a buffer are processed, 
the buffer is marked "free" in the RLD con- 
trol block. When a new multiplicity of 
text is to be relocated, the RLD note list 
is scanned sequentially (on ID and multi- 
plicity number) from the first entry. If 
an entry indicates that the record is "in 
core" and the record contains RLD items 
pertaining to the new multiplicity of text, 
it is processed. 
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FINAL PROCESSING (IEWLMFNL) 

The fourth phase of Linkage Editor F 
(final processing) performs "cleanup" func- 
tions, and is the last operation of linkage 
editor processing. Functions of final pro- 
cessing include: 

• Write the TTR note list r created during 
second pass processing , on SYSLMOD if 
the output load module is to be used in 
overlay. The TTR list contains the 
relative track address of the first 
record of each segment of the overlay 
load module. It is used by program 
fetch to find the segments when it 
loads them into main storage for 
execution. 

• Place each entry in the proper format 
for the partitioned data set directory , 
modify it if there are alias symbols , 
and issue a STOW macro instruction 11 for 
the member name and each alias. 

• Check attributes (reusable, reentrant, 
and refreshable) . If the attributes 
have become more restrictive, a message 
describing the change in attributes is 
printed out. (For example, the input 
module was specified as "reusable" and 
is now "not reusable. ") 

• Print out a directory of logged errors. 

• Produce a cross-reference table if the 
XREF option is specified, and the 
cross-reference table was not produced 
during intermediate output processing. 

• If the module has been marked "not 
executable," an error message is 
printed out. 

• If a NAME card, not followed by end of 
file, terminated SYSLIN input, linkage 
editor processing is repeated, begin- 
ning with initialization. 

• If end of file terminated SYSLIN input, 
linkage editor processing is completed. 



11 The STOW macro instruction is not issued 
if there was no valid input, if there were 
no ESDs, if nothing was written out on 
SYSLMOD, or if the run was terminated by a 
severity 4 error. 



Allocated main storage is released, and 
control is returned to the caller. 



Error Logging 

Whenever an error condition is detected 
during linkage editor processing, an indi- 
cator is set in an error logging map and a 
coded diagnostic message is printed out. 
During final processing, the error logging 
map is scanned. When an indicator is found 
"on" in the map, an associated list is used 
to build a diagnostic message. 

Note : An example of error logging in level 
F is given in Figure 33. Each entry in the 
list contains a length indicator and a 
pointer to a phrase to be assembled into 
the message. (Phrases are stored to save 
main storage space; complete messages would 
reguire additional space due to repetition 
of identical phrases.) The diagnostic 
directory is then printed out, one or two 
lines to a message. 

All error messages produced by the link- 
age editor are identified by a message ID 
having the format: 

IEWDMMS 

where : 

IEW - identifies the message as a linkage 
editor error message. 

D - contains a zero. 

MM - is the message number. 

S - is the severity code. 

The module in which an error message 
occurred is identified by the message num- 
ber (MM) . (Refer to Section 6 for an error 
message-module cross reference table.) 



Cross-Reference Table 

If the XREF option is specified, and the 
cross-reference table was not produced dur- 
ing intermediate output processing, the RLD 
records are read back from SYSLMOD, and the 
cross-reference table is built, as 
described in the discussion of intermediate 
processing. 
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* This pointer is determined by subtracting the 
bit number from the length of the error 
logging map (64 - 16 = 48). 

Figure 33. Building Error Messages 
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Figure 9. Operation Diagram A 4 - Final Processing 
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Figure 10. Operation Diagram B1 - Control Statement Processing 
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• The type of each input ESD item is determined 

• The CESD is scanned for a matching symbol 

• If no match is found, non-resolution processing 
is performed (A,C,E) 

• If a match is found, resolution processing is 
performed (B,D,F) 

Figure 16. Operation Diagram B2 - ESD Processing 
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• Text record IDs are renumbered (A) 

• CSECT lengths obtained (B) 

• Assuming there is space in TXTBUF1, 
text records are moved (C) 

• Entries made in Text I/O Table and 
Text Note List (D) 

• Contents of TXTBUF1 written onto 
SYSUT1 (E) 

• TTR entered into Text Note List (F) 
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Figure 17. Operation Diagram B3 - Processing Object Module Text 
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The ID in the first control record is renumbered. 
The third line of the RNT contains a 4, so the ID 
is renumbered to refer to the fourth line of the 
CESD (CSECTDD). 

Assuming CSECT DD (CESD ID = 4) is not to be 
deleted, its length (in the control record) is checked. 

If the entire CSECT or a complete multiplicity will 
fit in TXTBUF1, the record containing text for DD 
is read into TXTBUF1 , and entries are made in the 
text I/O table and the text note list*. 

Each subsequent control record is processed . Text 
records are read into TXTBUF1 until it becomes full, 
at which time its contents are written onto SYSUT1 . 

In the two text records in this example, the multi- 
plicity number is 0, since they are the first text 
records for their respective control sections. 
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Figure 18. Operation Diagram B4 - Processing Load Module Text Records 
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• Register 6 initially points to the first RLD input record. 

• RLD records are grouped in the RLD buffer by P pointer. 

In this example, the first and second, and third and fourth 
RLD records are grouped. 

• R and P pointers are renumbered, using the renumbering table, as 
RLD records are moved into the buffer. 

• Entries for each RLD set are made in the RLD notelist. Length 
and displacement fields refer to the first record of the set. 

• When the contents of the RLD buffer are written, the displacement 
field of the RLD note list entry for the last set included in the output 
record is replaced by the relative track address (TTR) of the SYSUT1 
record . 

Figure 19. Operation Diagram B5 - RLD Processing 
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Figure 22. Operation Diagram C1 - Address Assignment 
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Figure 26. Operation Diagram D1 - Data Movement During Second Pass Processing 
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SECTION 3: PROGRAM ORGANIZATION 



The following text and the flowcharts at 
the end of this section describe the pro- 
cessors (code modules r control sections , 
and routines) that accomplish the functions 
of Linkage Editor F. The organization of 
this section corresponds to the organiza- 
tion of the linkage editor; descriptions of 
all processors which constitute a phase of 
the linkage editor are grouped together. 
For each processor the symbolic name is 
given to facilitate use of program listings 
(see "Section 4: Michofiche Directory") 
and the descriptive name is given to facil- 
itate reference to the Method of Operation" 
section (Section 2) . 

Figure 34 (a f oldout) shows the overall 
organization of Linkage Editor F; this 
figure is designed to help determine rela- 
tionships among the processors described in 
this section. 

Refer to the microfiche directory (Sec- 
tion 4) for the chart numbers associated 
with each module. 



Routines Called: None 



Exits : When attribute and option proces- 
sing is completed , IEWLMOPT returns control 
to the initial processor (IEWLMINT) . 



Allocation Processor 



AL001 



Entrance : AL001 is entered from the ini- 
tial processor after all data sets (except 
SYSLIB and SYSUT1) are opened. 

Operation : AL001 issues the GETMAIN macro 
instruction and assigns storage to buffers. 
The remaining storage is assigned to 
tables , with variable tables being assigned 
as much storage as possible. 

Routines Called : None 

Exits : When allocation processing is com- 
pleted, AL001 returns control to the ini- 
tial processor (IEWLMINT) . 

Input Processor — IEWLMINP (Chart JA) 



INITIALIZATION AND INPUT PROCESSING 

Initial Processor — IEWLMINT (Chart IA) 

Entrance : IEWLMINT is entered from 
IEWLMROU at the beginning of linkage editor 
processing. 

Operation : IEWLMINT performs initializa- 
tion functions , including: building the 
all purpose table (APT) , opening data sets, 
analyzing attributes and options passed by 
the calling program, and allocating main 
storage for internal tables, buffers, and 
work areas. 



Entrance : IEWLMINP receives control from 
the initial processor when all initializa- 
tion functions are completed. 

Operation : IEWLMINP reads and initially 
processes all linkage editor input. Input 
type (object module or load module) and 
input conditions are determined, and con- 
trol is passed to appropriate processors. 

Routines Called : IEWLMINP calls the fol- 
lowing processors: 

• Control statement scanner (IEWLMSCN) 
when a control statement is detected 
(blank in column 1) . 



Routines Called : IEWLMINT calls the attri- 
butes and options processor (IEWLMOPT) and 
the allocation routine (ALL001) . 



Object module processor (IEWLMMDI) when 
object module input is detected (SYSLIN 
input or F-f ormat input from SYSLIB) . 



Exits : When initialization is completed, 
IEWLMINT passes control to the input pro- 
cessor (IEWLMINP) . 



Load module processor (INP270) when 
load module input is detected (U-f ormat 
input from SYSLIB) . 



Attributes and Options Processor — 
IEWLMOPT 

Entrance : IEWLMOPT is entered from the 
initial processor after all data sets 
except SYSLIB and SYSUT1 are opened. 

Operation : IEWLMOPT analyzes the options 
requested and the attributes specified by 
the calling program, and notes this infor- 
mation in the APT. 



• Include processor (IEWLMINC) at end-of- 
input, if more modules must be 
included. 

• Automatic library call processor 

(IEWLCAUT) at end-of- input on SYSLIN, 
if the NCAL option is not specified. 

Exits: When input processing is completed, 
IEWLMINP passes control to the address 
assignment processor (IEWLMADA) if valid 
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input was received. If no valid input was 
received , control is passed to the final 
processor (IEWLMFNL) to terminate linkage 
editor processing. 



Control Statement Scanner — IEWLMSCN 
(Charts J0 r JP) 

Entrance : IEWLMSCN is entered from the 
input processor when a control statement is 
detected. 

Operation : Depending on the type of con- 
trol statement being processed , the control 
statement scanner makes entries in the APT, 
SEGTA1, and the CESD. This information is 
used to control subsequent linkage editor 
processing. 

Routines Called : IEWLMSCN calls the READ8 
routine (Chart JQ) to process control 
statement operands. 

Exits : When control statement processing 
is completed, IEWLMSCN passes control to 
the include processor (IEWLMINC) if an 
INCLUDE control statement was processed 
(include chain built in the CESD) . Other- 
wise, IEWLMSCN returns control to the input 
processor. 



Object Module Processor — IEWLMMDI (Chart 
JB) 

Entrance : IEWLMMDI is entered from the 
input processor when object module input is 
detected. 

Operation : IEWLMMDI determines the input 
record type (SYM, TXT, RLD, ESD, END) , 
loads input record information into general 
registers, and passes control to the appro- 
priate processors. 

Routines Called : Depending on input record 
type, IEWLMMDI calls the following 
processors: 

• SYM Processor (IEWLMSYM) 

• ESD Processor (IEWLMESD) 

• END Processor (IEWLMEND) 

• Text and RLD Processor (IEWLMRAT) 

Exits : When object module processing is 
completed, IEWLMMDI returns control to the 
input processor. 

Load Module Processor — INP270 (Chart JQ 

Entrance : INP270 is entered from the input 
processor when load module input is 
detected. 



Operation : INP270 determines the input 
record type (TXT, CESD, scatter/ 
translation, SYM, CCW, CCW/RLD, RLD) , loads 
input record information into general regi- 
sters, and passes control to the appropri- 
ate processors. 

Routines Called : Depending on input record 
type, INP270 calls an associated processor, 
as shown in Table 8. 

Exits : When load module processing is com- 
pleted, INP270 returns control to the input 
processor. 

Table 8. Load Module Record Types and 
Associated Processors 



1 — - ■- - -■ - 

| Record Type 

1 


■ T ~ 

| Processor 


1 
i 


| TXT | IEWLMRAT 
| CESD | IEWLMESD 
j Scatter/Translation j (Ignored) 
| SYM | IEWLMSYM 
| CCW j IEWLMRAT 
| CCW/RLD | IEWLMRAT 
j RLD j IEWLMRAT 

j If en d-of -module indicator is on: 

I „_ _ m _ „, ... , ..._. 
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i 
i 
i 
i 
i 
i 
i 
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1 
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| CCW 

| CCW/RLD 

j RLD 

ESD Processor — IEWLMESD 
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| IEWLMEND 
j IEWLMEND 
| IEWLMEND 

(Charts JE, JF, 


1 

1 
1 
1 


jgl 

Entrance: IEWLMESD is entered from the 





object module processor when an ESD record 
is detected, and from the load module pro- 
cessor when a CESD record is detected. 

Operation : IEWLMESD combines ESDs in the 
linkage editor input into a composite ESD. 
Matching input symbols are resolved, and 
specified operations (replace, change, 
delete) are performed on the symbols. A 
renumbering table (RNT) is produced to 
allow input ESD IDs to be translated into 
CESD IDs. 

Routines Called : None 

Exits: When ESD processing is completed, 
IEWLMESD returns control to the routine 
from which it was entered (object module 
processor or load module processor) . 



SYM Processor — IEWLMSYM (Chart JD) 

Entrance : IEWLMSYM is entered from the 
object module processor when SYM records 
have been detected and the TEST option has 
been specified. If TEST is not specified, 
SYM records are ignored. 
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Operation ; IEWLMSYM gathers SYM records in 
the RLD input buffer, and writes the buffer 
contents onto SYSLMOD when the first TXT 
record of a module is detected. 

Routines Called : None 

Exits : When SYM processing is completed, 
IEWLMSYM returns control to the object 
module processor. 



Operation : RLD001 groups RLD items in the 
RLD buffer and renumbers the R and P point- 
ers to refer to appropriate CESD entries. 
Each RLD item is processed according to its 
flag and address (FA) field. RLD001 also 
creates an RLD note list, with entries for 
each set of RLDs (a set being all RLDs hav- 
ing the same P pointer) . If either the RLD 
buffer or the RLD note list becomes full, 
the contents of the buffer and the note 
list are written onto SYSUT1. 



Text and RLD Processor — IEWLMRAT (Chart 
JH) 



Entrance: 



IEWLMRAT is entered from the 



object or load module processors when a 
text or RLD record is detected. 



Routines Called : When the RLD buffer or 
the RLD note list is full, RLD001 calls the 
RLD write routine (RLDBUF — Chart JM) to 
write the note list and the buffer contents 
onto SYSUT1. 



Operation : IEWLMRAT determines record type 
(TXT or RLD) , checks for error conditions 
(input record larger than buffer) , and 

passes control to the appropriate 

processor. 

Routines Called : Depending on the record 
type, IEWLMRAT passes control to either the 
text processor (IEWLMTXT) or the RLD pro- 
cessor (RLD001) . 

Exits : When text and RLD processing is 
completed, IEWLMRAT returns control to the 
object or load module processor. 



Exits : When RLD processing is completed, 
RLD001 returns control to the text and RLD 
processor. 



End Processor — IEWLMEND (Chart JN) 



Entrance : IEWLMEND is entered from the 
object or load module processor when an END 
statement or the end of a load module is 
detected. 



Text Processor — IEWLMTXT (Chart JI) 

Entrance : IEWLMTXT is entered from the 
text and RLD processor when a text record 
is detected. 

Operation : IEWLMTXT operation depends on 
whether text input is from object or load 
modules. Object module text is moved from 
the object module buffer to the input text 
buffer, and must be arranged in the proper 
order. Load module text input is already 
ordered, so IEWLMTXT reads it directly into 
the input text buffer. In either case, the 
input text ID is renumbered to refer to the 
CESD ID of the appropriate control section. 
When the input text buffer becomes full, 
its contents are written onto SYSUT1. 

Routines Called : When the input text buff- 
er is full, IEWLMTXT calls the text write 
routine (TXTBUF — Chart JJ) to write the 
buffer contents onto SYSUT1. 

Exits : When text processing is completed, 
IEWLMTXT returns control to the text and 
RLD processor. 

RLD Processor — RLD001 (Charts JK, JL) 

Entrance : RLD001 is entered from the text 
and RLD processor when an RLD record is 
detected. 



Operation : IEWLMEND resets tables involved 
in input processing, processes entry point 
information, deletes CESD lines marked 
CHAIN or DELETE, and enters into the CESD 
the length of control sections for which no 
length was previously indicated. 

Routines Called : None 

Exits : When end processing is completed, 
IEWLMEND returns control to the object or 
load module processor. 



Include Processor — IEWLMINC (Chart JR) 

Entrance : IEWLMINC is entered from the 
input processor when "more includes" are 
indicated at end-of- input, and from the 
control statement scanner when an INCLUDE 
statement has been processed. 

Operation : IEWLMINC examines the include 
chain in the CESD and selects the next 
module to be included. It opens the data 
set, determines the attributes of the 
module to be included, and initializes the 
DCB to allow the module to be read. 

Routines Called : None. 

Exits : When include processing is com- 
pleted, control is returned to the input 
processor. 
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Automatic Library Call Processor — 
IEWLCAUT (Charts JS, JT) 

Entrance : IEWLCAUT is entered from the 
input processor at the end of SYSLIN input r 
or when a NAME statement has been detected 
(provided that the NCAL option was not 
specified) . 

Operation : IEWLCAUT first scans the CESD 
for unresolved ERs specified on LIBRARY 
statements. It attempts to resolve these 
ERs by searching the PDS directories of 
ddnames included in library chains, allow- 
ing the members found to be read. A second 
CESD scan attempts to resolve ERs not spec- 
ified on LIBRARY statements by attempting 
to call them from SYSLIB. 

Routines Called : After the first series of 
CESD scans, IEWLCAUT returns control to the 
input processor to read the members. 

Exits : After the second series of CESD 
scans, IEWLCAUT passes control to the 
address assignment processor (IEWLMADA) . 



If the MAP option has been specified, a 
module map is produced and written on 
SYSPRINT; if the XREF option has been spec- 
ified and all RLDs are in storage, a cross- 
reference table is produced and written on 
SYSPRINT. 

If the TXT and RLD note lists were 
placed on SYSUT1 during TXT and RLD proces- 
sing, IEWLMOUT reads them back into 
storage, and builds the high ID table 
(HIID) . The half ESD (HESD) is also built, 
after the CESD has been written. 



Routines Called : IEWLMOUT calls the MAP/ 
XREF processor (IEWLMMAP) to produce and 
write the module map and cross-reference 
table, if requested. 

Exits : When intermediate output processing 
is completed, control is passed to the 
second pass processor (IEWLMSCD) . 



SECOND PASS PROCESSING 



INTERMEDIATE PROCESSING 

Address Assignment Processor — IEWLMADA 
(Chart KA) 

Entrance : IEWLMADA is entered from the 
input processor when input processing is 
completed. 

Operation : IEWLMADA assigns linked 
addresses to all CESD entries, determines 
the size of SEGTAB if the program is in 
overlay, determines the number of ENTAB 
bytes required for each segment, builds the 
alias table, and determines an entry point 
for the program. 

Routines Called : IEWLMADA call the ENTAB 
size determination routine (IEWMLENS — 
Chart KB) to compute the size of ENTABs, 
and calls the entry processor (IEWLMENT — 
Charts KC, KD) to build the alias table and 
determine an entry point. 

Exits : When address assignment processing 
is completed, IEWLMADA passes control to 
the intermediate output processor 

(IEWLMOUT) . 

Intermediate Output Processor — IEWLMOUT 
(Chart LA) 

Entrance : IEWLMOUT is entered from 
IEWLMADA when address assignment processing 
is complete. 

Operation : IEWLMOUT writes the following 
onto SYSLMOD: CESD, SEGTAB (for programs 
in overlay) , and scatter/translation rec- 
ords (for programs to be scatter loaded) . 



Second Pass Processor — IEWLMSCD (Charts 
MA, MB) 

Entrance : IEWLMSCD is entered from 
IEWLMOUT when intermediate output proces- 
sing is completed. 

Operation : IEWLMSCD performs the following 
functions: 

• Reads text from SYSUT1. 

• Relocates address constants contained 
in the text. 

• Creates control/RLD records. 

• Writes text and control/RLD records 
onto SYSLMOD in a format that can be 
loaded by program fetch. 

• Creates ENTABs and associated RLD items 
for overlay modules. 

Routines Called : During second pass pro- 
cessing, IEWLMSCD calls the following 
routines: 

• Control section search routine 

(GETIDMUL — Chart MC) to determine the 
next ID and multiplicity to be 
processed. 

• Text and RLD read routines (RDTXT, 
RDRLD — Chart MD) to read required 
text and RLDs from SYSUT1 . 

• Text write routine (WRTTXT — Chart ME) 
to write text onto SYSLMOD. 
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RLD/control record write routine 
(WRTCRRLD) to write RLDs and control 
records onto SYSLMOD. 

Relocation routine (RELOCATE — Charts 
MF, MG, MH) to relocate address con- 
stants (branch type and non- branch 
type) in the text. 

Common path routine (IEWLCPTH) to 
determine common segments in an overlay 
path. 

ENTAB creation routine (SCDENTAB) to 
create ENTAB items for each segment. 



Exits ; When second pass processing is com- 
pleted, control is passed to the final pro- 
cessor (IEWLMFNL) . 



FINAL PROCESSING 

Final Processor — IEWLMFNL (Chart NA) 

Entrance: IEWLMFNL is entered from 



IEWLMSCD when second pass processing is 
completed. 

Operation : IEWLMFNL performs the following 
"cleanup" functions: 

• Writes the TTR list for overlay modules 
onto SYSLMOD. 

• Places entries in the partitioned data 
set directory and issues a STOW macro 
instruction. 

• Prints a directory of logged errors. 

• Checks for more restrictive module 
attributes. 

• Produces a cross-reference table if it 
was requested and not produced during 
intermediate processing. 



Routines Called : During final processing, 
IEWLMFNL calls the following routines: 

• Diagnostic message directory print rou- 
tine (IEWLMBTP) which scans the error 
logging map produced throughout linkage 
editor processing by the error logging 
routine (IEWLMLOG — Chart NC) ; 
IEWLMBTP builds and prints a directory 
of error messages. 



• MAP/XREF processor (IEWLMMAP — Chart 
LB) which produces a cross reference 
table if it was not produced during 
intermediate processing. 

Exits : If end-of-file was not detected on 
a SYSLIN input, IEWLMFNL returns control to 
the initial processor (IEWLMINT) , and link- 
age editor processing is repeated. Other- 
wise, linkage editor processing is ter- 
minated, and control is returned to the 
control program. 



SYNAD Routine (Chart NB) 

Entrance: The SYNAD routine may be entered 
from the following routines: 

• From the control program when any I/O 
error has been detected. 

• From the second pass processor, if an 
error is found after executing XDAP 

Operation : Following are SYNAD considera- 
tions for linkage editor F: 

• The SYNAD fields of the DCBs in 
IEWLMROU contain the address of the 
appropriate SYNAD entry point for the 
access method used with the data set. 

• If the SYNAD routine is entered from 
the input processor because of incor- 
rect length, the length of the incor- 
rect input block is checked. If a 
valid short block (integral multiple of 
LRECL) is found, control is returned to 
the supervisor to continue processing; 
if not, processing is terminated with 
an error message and completion code of 
16. 

• If the SYNAD routine is entered while 
writing to the SYSPRINT data set, con- 
trol is passed to the final processor, 
and execution is abnormally terminated 
with a condition code of 16. 

• When the include processor opens the 
DCB for SYSLIB, the address of the 
appropriate SYNAD entry (for either 
BSAM or BPAM access methods) is moved 
into the SYNAD field. 

• If the second pass processor finds an 
error after executing XDAP, it loads 
register 1 with the IOB address, loads 
register 15 with the SYNAD entry point 
for EXCP, and branches on register 15. 
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Figure 34. Linkage Editor F Organization 
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Chart HA. Level F Major Divisions 



»*** A3 ********* 

* CONTROL * 

* PROGRAM * 

* * 
*************** 



-*—*—*—*- 



***************** 



INITIAL PROCESSING 



-*—*—*—*—*—*- 



******* 



INPUT PROCESSING 



*****C3* ********* 

* IEWLMINP JA * 
*—*—*—•—*—*-*—*-* 

* INPUT * 

* PROCESSOR * 

* * 
***************** 



*—*—*—*—*— 



ADDRESS 

ASSIGNMENT 

PROCESSOR 



*****E3********** 

* IEWLMOUT LA * 
*—*—*—*—*—*—*—*—* 

* INTERMEDIATE * 

* OUTPUT * 

* PROCESSOR * 
***************** 



INTERMEDIATE PROCESSING 



* SECOND * 

* PASS * 

* PROCESSOR * 
***************** 



SECOND PASS PROCESSING 



*—*-*—*—*—*—*—*-* 



***************** 



FINAL PROCESSING 



****H3********* 
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Chart IA. Initial Processor (IEWLMINT) 



FROM ROOT SEGMENT (lEWLMROU) 
****A3********* 



* IEWLMINT * 

* * 
*************** 



*****B3********** 
*SAVE REGISTERS * 

* 3-12 AND * 

* PLACE ADDRESS * 

* OF APT IN * 

* REGISTER 2 * 
***************** 



*****C2********** 

* PLACE * 

* STANDARD * 
*DDNAMES IN DCBS*< 

* OF ALL DATA * 

* SETS * 
***************** 



PARAMETER *. 
LIST 
• PASSED .* 



*****C4********** 

* * 

* PLACE PASSED * 
>* DDNAMES IN * 

* DCB»S OF ALL * 

* DATA SETS * 
***************** 



FROM FINAL PROCESSOR 

****E 1 ********* 

* * 

* IEWLMNAM * 

* * 
*************** 



SYSLMOD *. YES 

DATA SET .* 

. OPEN •* 



**F2******* 



*********** 



*****03********** 

* SAVE DDNAMES * 

* FOR * 

* SYSUT1 AND * 

* SYSLMOD * 

* * 
******** 



**E3******* 

* OPEN * 

SYSLIN 

SYSPRINT 

SYSLMOD 



******** 



■** 



_*_»_*_*_ 



* ATTRIBUTES * 

* AND OPTIONS * 

* PROCESSOR * 
***************** 



FSTENTRY 

*****G3********** 

* ALLOCATE * 

* INPUT/OUTPUT, * 

* LOAD MODULE, * 

* RLD, TXT * 

* BUFFERS * 
***************** 



FSTENTRY 

*****H3********* 

* ALLOCATE 

* ALL 

* PROCESSING 

* TABLES 
* 

** 



♦CLEAR REQUIRED * 

* PARTS OF * 

* PROCESSING * 

* TABLES * 
***************** 



****K3********* 

* * 

* IEWLMINP * 

* * 
*************** 

TO INPUT PROCESSOR 
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Chart JA. Input Processor (IEWLMINP) 



****C1 ********* 

* EOF ON * 

* SYSLIN DCB * 

* * 
*************** 



IEWLMEON 

*****01 ********** 

* SET * 

* AUTOMATIC * 

* LIBRARY CALL * 

* INDICATOR ON * 
» * 
***************** 



***** El ********** 

* * 

* SET END * 

* OF INPUT * 

* INDICATOR ON * 

* * 
***************** 



****A2 ********* 

* * 

* IEWLMINP * 

* * 
*************** 



**** 

* * 

* B2 *-> 



**B2******* 

* * 

* * 

* READ A RECORD *- 

* * 

* * 
*********** 



• * *• 

CONTROL *. N 
STATEMENT •*- 



-*-*-*—* 



* CONTROL * 

* STATEMENT * 

* SCANNER * 
***************** 





LOAD * >* B2 




MODULE * * 




PROCESSOR * **** 


** 


************** 



****A5********* 

* * 

* DCB EXIT * 

* * 
*************** 



*-*—*—*—*—*—*—*-* 

* OPEN EXIT * 

* SET INDICATOR * 

* AND RETURN * 
***************** 



****C5********* 

* * 

* RETURN * 



*****D3* ********* 

♦IEWLMMDI JB* 

*-*—*—*-*—*—*—*—* 

>* OBJECT *— 

* MODULE * 

* PROCESSOR * 
***************** 



L 



*NA * 
->* G2 

FINAL * * 
PROCESSOR **** 



****G 1 ********* 

* EOF ON * 

* SYSLIB DCB * 



***** 
*JA * 
* H2* 



->* B2 * 



*****G2********** 

* SET * 

* AUTOMATIC * 
-* LIBRARY CALL * 

* INDICATOR ON * 

* * 
*********** 



**** 



IEWLMEOD 



FROM LOAD*. 
MODULE * 
PROCESSOR 



************ 



.* AUTOMATIC *. 

♦.LIBRARY CALL • 

♦.INDICATOR.* 

*. SET .* 



****J4******* 

* TO 

* ADDRESS 

* ASSIGNMENT 
************* 



**** 

* * 

* B2 * 

* * 
**** 



* AUTOMATIC *- 

* LIBRARY CALL * 

* PROCESSOR * 
***************** 
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Chart JB. Object Module Processor (IEWLMMDI) 



FROM INPUT 
PROCESSOR 
****A1 ********* 

* * 

* IEWLMMDI * 

* * 
*************** 



.* CONTROL *. 

STATEMENT 

*.CONTINUA-.* 



***** A3* ********* 
*IEWLMLOG NC* 
*_*_*_*_*_*_*_*. 

->* CONTINUATION 
*EXPCTD BUT NOT 
* RECEIVED 
***************** 



n 



INP22 

*****B2 ********** 
*LOAD PARAMETER * 

* REGISTERS AND * 

* SET IN MODULE *- 

* INDICATOR IN * 



**** 



A.P.T. 
************* 



NO .* 

*. RLD 

*. RECORD 



*JC 


* 








* G3 


* 






* * 








* 








• *• 


INP150 .*• 






B3 *. 


B4 *. 


***** 


35********** 


*. 


• * *• 


* 


* 


SYM *. YES 


.* TEST *. YES 


* 


LOAD * 








WITH BYTE * 
COUNT * 


.* 


*. ON .* 


* 


.* 


*. •* 


* 


* 


*. .* 


*• • * 


***** 


************ 


* NO 

1 

1 


* NO 

1 **** 

*JC * 
«— >* G3 * 

* * 








V 


**** 








.*. 


INP140 




V 


C3 *. 


*****C4********** 


*****C5********** 


*• 


* * 


♦IEWLMSYM JD* 


ESD *. YES 


* SET * 


*— *— * 


-*—*—*-*—*-* 


RECORD .* 


>* ESD INDICATOR * 


* 


SAVE * 


• * 


* ON * 


* 


SYM * 


• •* 


* * 


* 


RECORD * 


*• •* 


***************** 


***** 


************ 



***************** 



*****£! ********** 

♦IEWLMRAT JH* 
*-*—*-*—H— *—*—*-* 

* RLD AND TXT * 

* PROCESSOR * 

* * 
***************** 



•* WERE *. YES 

*. SYM RECORDS .* 

♦.RECEIVED .* 



*****E2** ******** 



*—*—*—*—*— 



-*—*—*—*- 



********* 



*****E3 ********** 



***************** 



***** 
*JC * 
* G3* 



L 



***************** 



.* SYM *• N 
->*RECEIVED INDI-.*- 
*.CATOR ON .* 



************* 



*—*—*—*—*— 



♦UNRECOGNIZABLE * 

* I NPUT-NOT * 

* OBJECT MODULE * 
***************** 



ENTRY 

POINT 

.INDICATOR. 



?*•*"* | 



**** 

* * 

* F4 * 

* * 
**** 



*****P4********** 

* LOAD GR4 * 

* WITH CONTROL * 
♦SECTION LENGTH *- 
♦FROM END RECORD* 



**** 

* * 
<— * F4 * 

* * 
NO**** 



***************** 



***** 
*JC * 
* G3* 



ABSOLUTE 
ENTRY 
POINT 



*****H3********** 

* * 

* SET ABSOLUTE * 

* ENTRY POINT * 

* INDICATOR IN * 

* A. P. T. * 
***************** 



*****j3********** 

* STORE * 

* ASSEMBLED * 

* ADDRESS IN * 

* A. P. T. * 

* * 
***************** 



**** 

* * 

* F4 * 

* * 
**** 



.* SYMBOLIC 
*. ENTRY 
*. POINT 



*****H4******** 
* 

* SET SYMBOLIC 

* ENTRY POINT 

* INDICATOR IN 



*****J4********** 



* IN A. P. T. * 

* * 
***************** 



*****K4*« 



GR4 
CONTAINS 
• LENGTH 



****G5********** 

SET * 

NO LENGTH * 

RECEIVED * 

INDICATOR IN * 



P. T. 

********** 



t***** 



-*—*—*—* 



******* 



********* 



*****J5********** 
•IEWLMRAT JH* 
*_*_*_*_*_*-*_*_* 

* END CARD * 

* PURGE * 



*********** 



***** 
*JC * 
* G3* 



*** 



********* 
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Chart JC. Load Module Processor (INP270) 



****A1********* 

* * 

* INP270 * 

* * 
*************** 



SYM RECORD 



ESD RECORD 



*. RLD RECORD 



Fl *. 
.* *. 
.* 

*• RLD RECORD 



*. 



NO 



L 



**** 

* 

->* G3 * 

* * 
**** 

*****C2 ********** 



L 



***************** 



*****D 2 ********** 
*l_OAD NUMBER OF * 

* BYTES OF RLD * 
>* INFORMATION *— 

* INTO GENERAL * 

* REGISTER 4 * 
***************** 



*—*—*—*—*—*—*—*—* 
>* * 

* SYM PURGE * 

* * 
***************** 

**** 

* * 
->* G3 * 

* * 
**** 

*****C3 ********** 
♦LOAD NUMBER OF * 

* BYTES OF CESD * 
>* INFORMATION *- 

* INTO GENERAL * 

* REGISTER 4 * 
***************** 



*****D3********** 

* LOAD STARTING * 
♦ADDRESS OF RLD * 

>* INFORMATION *- 

* INTO GENERAL * 

* REGISTER 6 



****** 



**** 



*****E2********** 

* LOAD ASSIGNED * 

* ADDRESS OF * 
>* FOLLOWING TXT *- 

* INTO GENERAL * 

* REGISTER 3 * 
***************** 



**** 
* * 
->* G3 * 



LAST RECORD 



-*-*—*—*—*-*— 



***************** 



*****E3********** 

* LOAD * 

* BYTE COUNT OF * 
>* TXT INTO *— 

* GENERAL * 

* REGISTER 4 * 
***************** 



**** 

* 

* F3 
* 
**** 



n 



-*. LAST RECORD .*<- 



*****C4 ********** 

* LOAD * 

* ESD ID OF 1ST * 
>* ENTRY INTO *- 

* GENERAL * 

* REGISTER 5 * 
***************** 



*****04********** 

*IEWLMRAT JH* 

*—*—*—*—*—*—*—*—* 

>* PROCESS * 

* RLD * 

* INFORMATION * 
***************** 



->* 



*****C5********** 
*LOAD ADDRESS OF* 

* CESD * 
INFORMATION * 

INTO GENERAL * 

* REGISTER 6 * 
***************** 



*****E4 ********** 

* * 

* LOAD ID INTO * 
>* GENERAL *- 

* REGISTER 5 * 

* * 
***************** 



*****D5***«* 
♦IEWLMESD 


***** 
JE* 


* PROCESS * 

* ESD * 

* INFORMATION * 
***************** 






**** 




* 


* 




«->* 

* 


G3 * 
* 
**** 


*****E5********** 
*IEWLMRAT JH* 
*-*—*—*—*—*—*—*—* 


* 

* 
* 


PROCESS 
TEXT 
INFORMATI 


* 

* 

ON * 



**** | 




*JC * J 




* G3 *->| 




* * | 




**** v 




NP110 .*. 


• *• 


G3 *. 


G4 *. 


.* *. 


.* *. **** 


.* IS RETURN *. YES 


.* IS ESD *. NO * 










*. PROCESSOR.* 


♦.INDICATOR.* * < 


*• •* 


*■ ON •* **** 



**** 

* * 

* K5 * 

* * 
**** 



*****TO INPUT 
*JA *PROCESSOR 
* H2* 



->* K5 * 

* * 
**** 



* UNRECONIZABLE 

* INPUT LOAD 

* MODULE 
**************** 



*—*—*—*—*—*-*— 

* SAVE 

* ESD 

* CARD 
************** 



NO .* IS * 

*. INPUT A LOAD 

*. MODULE .* 



***************** 



*—*—*—*-*—*—*—*—* 
>* * 

* SYM PURGE * 

* * 
***************** 

**** 

* * 

* K5 *-> 

* * 
**** 

****K5********* 

* * 

* RETURN * 

* * 
*************** 
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Chart JD. Sym Processor (IEWLMSYM) 



FROM LOAD OR 
OBJECT MODULE 
PROCESSOR 



* -x 

* IEWLMSYM ♦ 

* * 
*************** 



-♦.OBJECT MODULE.* 



*****C1 ********** 

* * 

* INITIALIZE * 
*FOR WRITE FROM * 

* RLD BUFFER * 

* * 
***************** 



.* IS RLD *. NO 

♦.BUFFER TO BE .* 

*. PURGED .* 



SYM00900 

*****C3* ********* 



* MOVE SYM/ESD 
->* RECORD TO RLD 

* BUFFER 



*****D2 ********** 

* * 
♦INITIALIZE FOR * 
♦WRITE FROM OBJ.* 

* MODULE BUFFER ♦ 

* * 
***************** 



***************** 



*****D3********** 



♦INCREMENT COUNTS 



***************** 



SYM00300 V 

******E2 *********** 



WRITE AND CHECK 



************* 



****F2 ********* 

* * 

* RETURN * 

* * 
*************** 

TO LOAD OR 
OBJECT MODULE 
PROCESSOR 
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Chart JE. ESD Processor (IEWLMESD) 



K*A1 ********* 
* 
IEWLMESD * 
* 

************* 



*B1* 



***•! 

♦INITIALIZE SAVE* 

* ESDID, NO. OF * 
*ESD ITEMS, ESD * 

* TYPE. ADDR OF * 

* CESD AND RNT * 
***************** 



*JE * 




* CI *-> 




* * 




**** y 


ESD1A0 .*. 


CI *. 


-* IS < 


.* ESD TYPE 


*. PSEUDO 


♦.REGISTER 


*.(PF 


o . 



.* ANY *. YES 

♦REPLACE/CHANGE.* 

*. SYMBOLS .* 



.* IS ESD *. 

*.TYPE PRIVATE • 

♦.CODE (PC).* 



*****C 2 ********** 

♦ * 
♦INSERT CURRENT * 

->*SEGMENT NUMBER *- 

♦ IN ESD ( IN BYTE* 

♦ 12) ♦ 
***************** 



*****B3* ********* 

* * 

* SET * 
•SEGMENT NUMBER *- 

* TO ONE * 

* * 
***************** 



.* AUTOMATIC *. 
->*. LIBRARY CALL . 
♦.INDICATOR.* 
♦. ON .♦ 



C4 ♦. 

.♦IS ESD ♦. 
* TYPE 

EXTERNAL 

*. REFERENCE. 

♦.(ER) .♦ 

♦. .♦ 

♦ NO 



-♦—♦—♦-♦ 



***************** 



-*—*—*—*—* 



>♦ SET POINTER 

♦ TO NEXT LINE 

* OF CESD 
**************** 



*****C5*** ******* 

* * 

* ZERO BYTES * 
>*10, 11, AND 12 * 

* OF ESD ITEM * 

* * 
***************** 



IS THIS 
AN OBJECT 
. MODULE 



*****E5********** 

* * 

* ZERO * 
-* THE SUBTYPE * 

* FIELD * 

* * 
***************** 



*.ESD TYPE NULL.*- 



***** 
*JF * 
* E2* 



.*IS ESD *. 
.*TYPE LABEL 
• DEFINITION 
*. (LD) 



**** 

*JE * 

* HI *-> 



**** 
ESD4 

*****H1 ********** 

* * 

* SEARCH THE * 

* CESD FOR A * 
♦MATCHING SYMBOL* 

* ♦ 
***************** 



♦ Jl ♦-> 



*****G2 ********** 

* * 
♦CHANGE TYPE TO ♦ 

>♦ LR INDICATE ♦ 
♦THAT IT WAS AN * 

* LD * 
***************** 



.* IS THIS *. 
*. THE END OF 

*.THE CESD .* 



.* DOES ESD 
->*. MATCH CESD 
*. SYMBOL . 



*****RESOLUTION 
*JG *PROCESSING 
* Al* 
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Chart JF. ESD Processor (IEWLMESD) 



***** 

*JF * 
* Al* 



ESD23 V 

*****A1 ********** 
♦FREELINE * 
*-*-*—*-*—*—*—*-* 

* SELECT NEXT *- 

* AVAILABLE * 

* LINE IN CESD * 
***************** 



*****C1 ********** 

* MARK COMMON * 

* ITEM AS A * 
♦DELETE ITEM AND*<- 

* SET COMMON * 

* INDICATOR * 
***************** 



A2 *. 
.* IS *. 

.* ESD TYPE *. 

LABEL 

♦-REFERENCE.* 

*.(LR) .* 

*. .* 

* NO 



-*—*—*—* 



>* RENUMBER ID *- 

* FIELD OF * 

* LABEL ITEM * 
***************** 



V 

.*. 

B2 *• 
.♦ IS *. 
.*ESD TYPE A *. YES 


**** v 
ESD21 •*. 

B3 *. 
.* IS *. 

.* AUTOMATIC * 


♦.FINITION .* 

*.(SD) .* 

*. .* 


♦.INDICATOR.* 

*. ON .* 

*. .* 



.*. ESD22 V 

C2 *• *****C3********** 

.* *. * INDICATE * 

YES .* IS ESD *. NO *THAT ESD IS SD * 


*. (CM) .* 

*. .* j 

*. .* V 

* **** 
**** * * 
*JF * * El * 

* D2 * j * * 

* * 1 **** 


♦WRITE INDICATOR* 

* IN APT * 
***************** 

**** 
*JF * 

* D3 *-> 

* * 



*****B4 ********** 

* INDICATE * 

* SD IS FROM * 
>* A LIBRARY * 

*(AUTOLIB INPUT)* 

* * 
***************** 



**** 

* * 

* El * 

* * 
**** 



********* 



-*—*—*—* 



ENTER THE 

ITEM IN THE 

CESD 

*************** 



* E2 *-> 



.* IS *. 

.* LENGTH ID *. 

SAVED 

♦.INDICATOR.* 



♦.INDICATOR ON .♦- 



♦TRANSLATE ESDID* 
♦ TO CESDID IN ♦ 
♦RENUMBERING TBL* 
***************** 



*****F3********** 

♦ CLEAR ♦ 

♦ COMMON ♦ 
>♦ INDICATOR ♦- 

* PREPARE FOR * 

* DELINKING * 
***************** 



*****E4********** 
*SAVE NO LENGTH * 

* LINE ADDRESS * 

* AND SET ID * 
♦SAVED INDICATORS 

* IN APT ♦ 
***************** 



I— >* 



**** 



**** 

*****F4 ********** 

♦IEWLCDLK ♦ 

*-*—*—*—*—*—*—*-* 

>♦ BUILD ENTRY ♦ 

♦ FOR CESD LINE ♦ 

♦ IN DELINK TBL ♦ 
***************** 



ANY MORE ♦. 

INPUT ESD • 

ITEMS .♦ 



*****G4********** 

* * 

* GO TO NEXT * 
->*ESD ITEM -SAVE *- 

* ESD TYPE * 

* * 
***************** 



***** 
*JE * 
* CI* 



****H2^*^****** 

* * 

* RETURN * 

* * 
*************** 
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Chart JG. ESD Processor (IEWLMESD) 



RESOLUTION PROCESSING 



*JF * 
* E2* 
***** 



SAVE TYPE 
OF MATCHING 
CESD ENTRY 



********** 



•DETERMINE LINE * 
*NO. OF CURRENT * 
* CESD LINE * 
***************** 



*IS ESD *. 

TYPE 
DELETE/ 
REPLACE . 



IS ER 
UNMARKED 
. (ESD) 



* B3 ♦-> 



V 




**** v 






ESD17A .*. 


B2 *• 




B3 *. 


*IS CESD*. 




• *IS CESD* 


TYPE *. 


NO 


.* TYPE A 


DELETE/ 


» , 


*. LIBRARY 


REPLACE .* 


I 


*. MEMBER 



*****A4********** 

* CLEAR * 
•SUBTYPE DELETE * 

>♦ BIT IN CESD ♦- 
♦LINE (MAKE IT A* 

* REPLACE) * 
***************** 



*****B4********** 

* IEWLCDCN * 
*-*-*-*-*-*-*-*-* 

>* REMOVE * 
♦LIBRARY MEMBER ♦ 

♦ FROM CHAIN * 
***************** 



I **** 

♦JF 
L- >* A2 



* CESD * 

UNMARKED OR 

*. NEVER .♦ 

♦.CALL .♦ 



* MARK ♦ 

♦ CESD TYPE ♦ 

♦ MATCHED ♦ 

* * 
***************** 



CESD 


TYPE 


• * 


1 ! 


*. CESD TYPE 


NULL .* 




♦. DELETE 






i 


♦. • ♦ 


*• •♦ 




V 


♦• •* 




NO 




***** 

♦JE ♦ 

♦ Jl* 

* * 


* NO 

1 

V 
**** 


> 


/ 






♦ F5 ♦ 



IS ESD 


IS CESD 


GO 


A PR 


A PR 


TO 


YES 


NO 


JEJ1 


NO 


YES 


JEJ1 


NO 


NO 


JGJ1 


YES 


YES 


CONTINUE 



-♦.CESD TYPE PC 



*****D4********** 

♦ UPDATE LENGTH ♦ 

♦ OF CESD ENTRY *— 

♦ TO GREATER * 

♦ LENGTH ♦ 
***************** 



E4 *.(TYPE IS 
.* *.CD) **♦♦ 
.♦ IS ♦. YES ♦ 
.CESD TYPE LR .*——>* J4 



FIND 

COMMON PATH 

SEGMENT 



****F2********** 



IS ESD 
LENGTH 
GREATER 



*****G1 ********** 

♦ SET CESD * 
♦LENGTH EQUAL TO^ 

♦ ESD LENGTH ♦ 

♦ * 
******** 



ESD15A 

*****F5^ 
♦DELCHN 



t******* 



**************** 



ESD TYPE AN 



n 



ESD TYPE CM 



(TYPE IS 
ER) 



***** 
*JF * 
♦ A3^ 



*****H 1 ********** 

♦ SET ♦ 
♦CESD ALIGNMENT 

♦ EQUAL TO 
♦HIGHEST OF CESD^ 

♦ AND ESD 



n 



•CESD TYPE AN 



ESD TYPE AN 



.♦ IS CESD 
->♦. ITEM FOR A 
♦. CONTROL . 
♦.CARD .♦ 



♦ IS ESD 

TYPE CM.SD, 
♦. OR LR . 



->^.CESD TYPE CM 



->♦ CREATE A LINE ♦ 
♦CHAINED TO LINE^ 
♦FOR MATCHNG SY ♦ 
***************** 

** j 

* j **** 
5 ♦ ♦JF ♦ 

* L_ >* D2 * 
** * * 

**** 

*****G5********** 
♦SET CESD LENGTH^ 

* EQUAL TO ♦ 
->*GREATER OF CESD* 

* AND ESD ITEMS * 

* * 
***************** 



•CESD TYPE AN 



n 



♦ DOUBLE LABEL 

♦ DEFINITION 

♦ ERROR 
*************** 



.♦ OVERLAY ♦. YES 


♦.INDICATOR ON .* 1 


♦. IN APT .♦ 


♦. .♦ 


♦. •* 


* NO 


j **** 


*JF * 


L- >* A2 * 


* * 


**** 


*****J5********** 


♦IEWLCPTH * 


*—*—*—*—*—*—*—*—* 


* FIND *< ' 



* COMMON PATH * 

♦ SEGMENT ♦ 
***************** 



*****K 1 ********** 

♦ * 

♦ SET CESD * 

♦ POINTER TO ♦ 

♦ 'CHAINED TO' ♦ 

♦ LINE ♦ 
***************** 



ESD17 .*. 

K3 ♦. 
• ♦ *• 
NO .♦ IS ♦. 

♦. CESD TYPE . 

*. DELETE .♦ 

♦ • •* 

♦• •♦ 

* 


YES 


*****K4********** 
♦IEWLCDLK * 
*— *— *_*_*—*—*—*- * 






A * CESD * 
| * LINE ♦ 
1 ***************** 
**** 


V 
***** 

♦ JF ♦ 

♦ A2* 



Section 3: Program Organization 97 



Chart JH. TXT and RLD Processor (IEWLMRAT) 



FROM OBJECT 

OR LOAD MODULE 

PROCESSOR 



****B3********* 

* * 

* IEWLMRAT * 

* * 
*************** 



C3 *. 
.* *. 
.* * 

*• END OF DATA 



*****C4 ********** 

* RLDBUF * 
*—*—*—*—*—*-*—*—* 

->* WRITE OUT * 

* RLD BUFFER * 

* * 
***************** 



* NO 







V 








• *. 








D3 


*. 








.* 


* 








.* 




*• 


YES 




•INPUT 


COUNT 












*- 


•* 





*****04 ********** 

* TXTBUF * 
*—*—*—*—*—*—*—*—* 

* WRITE OUT *- 

* TXT BUFFER * 

* * 
***************** 



****D5********* 

* * 
->* RETURN * 

* * 
*************** 



-*. RLD OR TXT 



F2 *• 

•* INPUT *• 
* SIZE *. YES 

EXCEEDS RLD •* 

*. BUFFER •* 



*****F3********** 

* IEWLMLOG * 
*—*—*—*—*—*—*—*-* 

->* INPUT RECORD *<- 

* TOO LARGE * 

* * 
***************** 



•♦INPUT SIZE *. 

• EXCEEDS TXT . 

*. BUFFER .* 



*****G2********** 

* RLDOOl * 
*—*—*—*—*-*—*-*—* 

* PROCESS * 

* RLD RECORDS * 

* * 
***************** 



*****G4********** 

* IEWLMTXT * 
*—*—*—*—*—*—*—*—* 

* PROCESS * 

* TXT RECORDS * 

* * 
***************** 



****H3********* 

* * 
->* RETURN *<- 

* * 
*************** 
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Chart JI. TXT Processor (IEWLMTXT) 



****A2********* 

* * 

* IEWLMTXT * 

* * 
*************** 



.* ALL *. 

ID-LENGTH *. 
1ST ITEMS TO.*<— 
.BE DELET-.* 



->*. END OF DATA 



.* ONE *. 

* PASS 
PROCESSING 



****B5***» 
* RETURN 



* B5 
* 
**** 



READ RECORD 



**** 

*****D1 ********* 

* RENUMBER 
*ID; UPDATE TXT 

* I/O TABLE AND 
*TEXT NOTE LIST 



C2 *. 

.* WILL *. 

.♦RECORD FIT * 

.IN AVAILABLE 

*. BUFFER .* 



***************** 



***************** 



*****D3**** ****** 

* * 

* RENUMBER ID * 

* * 

***************** 



*.TO BE DELETED. 



*****E2 ********** 

♦MOVE FOLLOWING * 
>* ID'S UP TO * 
•OVERLAY DELETED* 
* ID * 
***************** 



* : n 



.* NEW *. 
.* ENTRY *. YES 
*. CONTIGUOUS .* 



**** 

* * 

* B5 * 



.ANY MORE ID'S. 



* Dl * 

* * 

**•* 



*•** 
* * 

->* B5 * 



* CALCULATE * 

* MULTIPLICITY * 

* AND * 

* DISPLACEMENT * 

***************** 



.•CURRENT*. 
•*ID AND MULT* 
*. AGREE WITH 
*. PREVIOUS .* 



*****F5 ********** 



***************** 



*****H5********** 



NOW IN CORE .* 



***************** 



.* LENGTH 

♦.SPECIFIED 

*. CESD 



*****K 3* ****** 

* * 

* SET NO 

* LENGTH 

* INDICATOR 

* * 
************** 



*****J4******* 



************** 



* ALLOCATE 
>* NEW 

* MULTIPLICITY 

**************** 



*****K5********** 

* RECORD IN TXT * 

->* I/O TABLE AND * 

•TEXT NOTE LIST * 

***************** 
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Chart JJ. Level F TXTBUF Routine 



****A3********* 

* * 

* TXTBUF * 

* * 
*************** 



END OF DATA .*- 



•****B4********** 
» CLEAN UP * 

* NECESSARY * 
->*PORTION OF TEXT*— 

* BUFFER * 



******** 



!•*** 



*** 



*****B5********** 

* * 

* POST LENGTH * 
->»IF IN NO-LENGTH* 

* SITUATION * 

* • 
***************** 



****C5********* 

* * 

* RETURN * 

* * 
*************** 



•* MULT *. YES 

*. LARGER THAN .* 

*. SYSUT1 .* 



* NO 
**** 

* * 

* F3 *-> 

* * 
**** 

V 
*****F3********** 

* * 
♦RECORD CURRENT * 

* LENGTH AND * 
♦BUFFER ADDRESS * 



* WRITE ONE 
RECORD PER 
*TXTIOT ENTRY 

************* 



****E5**»* 

* * 

* RETURN * 

* * 
*************** 



*****G3 ********** 

* * 

* INCREMENT TO * 
>* NEXT TXTIOT ♦ 

* ENTRY * 

* * 
***************** 



*****H1 ********** 

* * 

* ADD PRESENT * 

* LENGTH TO *< 

* ACCUMULATED * 

* LENGTH * 
***************** 



* THIS MULT *. 
ONE LARGER . 
*.THAN LAST.* 



* ALL *. 
TXTIOT *. 
ENTRIES 
WRITTEN .* 



******H4*********** 

* WRITE ANY * 

-> ACCUMULATED 

* LENGTH * 

************* 



******* 



WRITE 

ACCUMULATED 

* LENGTH * 

************* 



.* LAST *• N 
•ENTRY HIGHEST. ♦- 
*. MULT .* 



**K3 ********** 



***************** 



**** 

* * 
->* F3 * 

* * 
**«* 
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Chart JK. Level F RLD Processor 



****A1* 
* 
* RLD001 

* 
************ 



FROM EOD 



r 



*****B2** ******** 

* * 
SET COUNTERS * 

>*FOR NEXT R AND * 

* P POINTERS * 

* # 
***************** 



****A4 ********* 

* » 

* RETURN * 

* * 
*************** 



***************** 



IS 

DELETE 

RNT 



#****C3* ********* 

* * 

* SET DELETE * 
->* FLAG AND SKIP * 

* RLD ITEM * 

* * 
***************** 



*—*—*-*—*-*-*-*—* 

* MAKE *< 

* BUFFER * 

* ENTRY * 
***************** 



* RENUMBER * 
>* R AND P * 

* POINTERS * 

* * 
***************** 



*—*—*—*—*—*—*—*—* 

* *< 

* DELINK * 

* * 
***************** 



-* RLD *. 
.♦FLAGGED AS *. NO 
->*. BRANCH TYPE .* 



.* IS R *• 

.* PSEUDO- * 
->*. REGISTER IN 
*. RNT .* 



***G5*** ******* 



***************** 



* SET 
♦ENTRY IN CALLS 

* LIST 
* 
**************** 



*****K2********** 

* * 

* UPDATE * 
-* COUNTERS FOR *< 

* NEXT FA FIELD * 

* * 
***************** 



YES .* EXTERNAL 

*. REFERENCE I 

*. RNT 



***J4********** 

FLAG * 

RLD FOR * 

RELATIVE * 

RELOCATION * 



********** 



***************** 



RLD0122 -*. 

K3 *. 

•*IS RLD 



'-] 



***** 
*JL * 
* 83* 
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Chart JL. Level L RLD Processor (Continued) 



***** 

*JL * 

* B3* 
* * 



B3 *• 
* 

DELETE 



*. .* 
* NO 



*****C2 ********** 

* RLDBUF * 
*—*—*-*—*—*—*-*—* 

* WRITE OUT *<- 

* RLD BUFFER * 

* * 
***************** 



NO .*SUFFICIENT 

*. SPACE IN 

*. BUFFER 



*****D2 ********** 



COMPRESS 



***************** 



V 
• *• 



* ID SAME *. 
AS PREVIOUS • 
*. ID'S •* 



*****E3 ********** 

* * 

* MOVE * 
->* RLD ITEMS TO * 

* BUFFER * 

* * 
***************** 



RLD0152 .*• 

F3 *. 
• * *• 
NO .* ALL *• 

I *. ITEMS •*<- 

| *. PROCESSED.* 
| *. .* 
V *. .* 

***** * YES 

*JK * 
* 82* 
* * 



****G3 ********* 

* * 

* RETURN * 

* * 
*************** 
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Chart JM. RLDBUF Routine 



**** At ********* 

* * 

* RLDBUF * 

* # 
*************** 



***A5********* 
* 
RETURN * 
* 

************** 



*. LOAD MODULE .*- 



RLDBUF3 



-*—*—*—*—*-* 



* ERROR * 

* * 
***************** 



•***D1 ********* 

* * 

* RETURN * 

* * 
*************** 



YES 
.*. 
HI *. 



r 



>*SET 2 PASS FLAG*<- 



***************** 



*****E2 ********** 

* * 

* FORMAT * 

* NOTE LIST *< 

* ENTRIES * 

* * 
***************** 



.* ANY 

BUFFER 
*. WRITTEN 



-*-*—*-*- 



***************** 



•*****H2*********** 



****E4 ********* 

* * 

* RETURN * 

* * 
*************** 



»****F4 ********** 



***************** 



->*. EOD 



RLDBUF2A .*. 



*****F5****** 



LIST FULL -*— 



***************** 



******G5 *********** 

* * 

-> WRITE LIST 

* * 

************* 



WRITE BUFFER 



RLDBUF7A 
H 
.* 
YES 



-♦.BUFFERS FULL .*<- 



************* 



**** j 3* ******** 

* * 

* RETURN * 

* * 
*************** 
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Chart JN. End Processor (IEWLMEND) 



* A3 * 
**** 



****A1 ********* 

* IEWLMEND * 

* * 
*************** 



*****B1 ********** 

* INITIALIZE * 

* RENUMBERING * 
•TABLE AND CESD * 
♦BASE REGISTERS * 

* * 
***************** 



.* THE ENTRY * 
•POINT BIT ON 
*. IN APT .* 



* CLEAR * 
♦REPLACE/CHANGE * 
♦BITS AND SYMBOL* 

* COUNT * 
***************** 



*****B3********** 

* SETUP * 

* LOOP INDEX TO * 

* REFER TO ♦ 

* RENUMBERING * 

* TABLE ♦ 
***************** 



♦RENUMBER THE ID* 

♦ FIELD FOR ♦ 

♦ ABSOLUTE * 

♦ ADDRESS * 

****** 



*****F1 ********** 

• SET * 
•ENTRY POINT BIT* 

♦ ON IN APT * 

***************** 



* IS RNT * 

TYPE DELETE 
*.OR CHAIN .* 



* REFER TO * 
->*CESD USING RNT * 

* ID VALUE * 

***************** 



* CESD *. YES 


ENTRY'S TYPE .* . 


*. DELETE .* 


*• •* 




* NO 


V 


• *• 


C5 *. 


.* IS *. 


• CESD *. 


ENTRY'S TYPE .* 


*. CHAIN .* 


*. .* 


*• •* 


* YES 



*****03********** 

* * 

* ZERO OUT * 

* RENUMBERING * 

* TABLE ENTRY * 

* * 
***************** 



-*.RNT LOOP DONE.* 



•***F3********* 

* * 

* RETURN * 

* * 
******•*••**••* 



.* LENGTH * 
.GIVEN IN END 
*. RECORD .* 



»****H2********** 
♦IEWLMLOG NC* 
ft—*—*—*—*—*—*—*—* 
>* NO LENGTH * 
* GIVEN FOR * 
•CONTROL SECTON * 
***************** 



•****F4********** 

* SAVE * 

* CESD ENTRY * 
•NUMBER AS FIRST*<- 

* OF THE CHAIN * 



************ 



**** 



***************** 



*****E5********** 

* * 

* INCREMENT * 
♦ENTRIES DELETED* 

* COUNT * 

* * 
•*****•**••****** 



YES .* THIS THE *. 

*. FIRST DELETED.* 

*. ENTRY .* 



•****G5********** 
•USING INDEX TO * 

* LAST ENTRY OF * 
•CESD CHAIN-PUT * 

* NEW ENTRY * 
•NUMBER IN CESD * 
*•***•*•***•*••** 



END6 V 

•****H5********** 

* PUT ENTRY • 

* NUMBER OF * 

* DELETED CESD * 
•ENTRY IN APT AS* 

* LAST OF CHAIN * 
***************** 



END1A V 

*****J1 ********** 

* PUT * 

* LENGTH INTO * 
•CESD ENTRY FOR * 

* THE CONTROL * 

* SECTION * 
***************** 



****** 1 ********** 

* TURN OFF 'NO * 

* LENGTH' * 
» INDICATOR IN * 

* APT • 

***************** 
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Chart JO. Control Statement Scanner (IEWLMSCN) 



****A1 ********* 

* * 

* IEWLMSCN * 



.*IS THIS*. 



*P1 TO COLUMN 



.* THIS A *. YES 

— >*CONTINUATION OF* 

*. COMMENTS .* 



THERE A 
BLANK IN 
•COLUMN 72. 



•****B5********** 
•RESET COMMENTS * 

* AND * 
->* CONTINUATION * 

* INDICATORS * 



*****C1 ********** 
*READ8 JO* 

*—*—•—*—*—•—*—*—• 
•READ OPERATION *<— 
*SYM-SET OPTION * 
•INDICATOR TO 1 * 



SET 

POINTER P2 TO 

OPD 1 



•****C3********** 
♦SET POINTER PI * 
•TO REAO COLUMN * 

* 16 * 

* (CONTINUATION * 

* OF OPERANDS) * 



DID SYMBOL *. NO 


END WITH A .* 1 

• BLANK .* 
*. .* I 


*. .* V 


* YES ***** 




*JP * 




* B4* 




* * 




* 



* SEARCH * 

* PROCESSOR KEY * 
♦TABLE FOR MATCH* 



•THERE A MATCH. 



SCN10120 

*****F2********** 

* SAVE ENTRY * 

* POINT OF * 
>*PROCESSOR -SET *— 

* POINTER P2 TO * 

* OPD * 
***************** 



.n 



*****G2********** 

* SET * 

* 'LEVEL' * 

* INDICATOR TO *<■ 

* ONE * 

* * 
************ 



* H2 *-> 



*****H2********** 

* SET * 

* POINTER P2 TO * 

* OPD 1 * 

* * 
***************** 



* OLD 

STATUS WAS 
*. LEVEL I . 



*****E3 ********** 

* * 

* SET * 

* POINTER P2 TO *— 

* OPD * 

* * 
***************** 



*****F3* ********* 

•TURN ON 'OPD * 

•NEW* INDICATOR * 

->*AND SET 'LEVEL'*— 

* INDICATOR TO * 

* ZERO • 
***************** 



.* ENDED *. 

* BY A LEFT *. 
PARENTHESIS .*<— 



n 



*****H3********** 
* * 

SET 'OPDO * 
ABSENT' *<■ 

INDICATOR * 



*****F4********** NOTE - OPTION 
*READ8 JQ* INDICATOR IS 

*-*-*-*-*-*-*-*-* SET TO 1 
->* READ 1ST OPND * 
♦OR CONTINUATION* 
* PARAMETER * 
***** 



**** 



SCN10130 .*. 

G4 *. 

.♦WAS AT *. 
YES .* LEAST ONE *. 

* VALID CHARACTER* 

*. READ .* 



.* ENDED *. 
* BY A LEFT 
PARENTHESIS 



SCN1 


0200 


• ♦. 








■;•> 


♦ « 












* 


NO 


• * 


ENDED 




i < . BY 


A 


BLANK 


r 


♦ • 






* 


V 




♦• •* 




***** 






♦ YES 


*JP * 










* B4* 











r 



*REAO NEXT SYMB * 
* -SET OPTION * 
♦INDICATOR TO ♦ 
***************** 



AT LEAST 
ONE VALID 
. CHAR 



SCN10140 

*****K3********** 
*PROCENTY * 



PASS CONTROL *— 
TO CTRL STMNT * 
PROCESSOR * 
**************** 



r*.IN COLUMN 72 
*%. ..• 



*****K5*********^ 

* * 

* SET * 

* CONTINUATION * 

* INDICATOR * 

* * 
***************** 
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Chart JP. Control Statement Scanner (IEWLMSCN) (Continued) 



SCN10150 



.*. 








.*. 


SCN10145 •*. 


1 *. 








A2 *. 




A3 ♦ . 


*• 








.* *. 




.* * 


LEVEL 


*. 


NO 




.* ENDED *. NO 




.* ENDED 


ONE 


. 


* 


>* 






. BY A BLANK 








* 






*. -* 




*. 


• * 








*• •* 




*. .* 


*. .* 








*• • * 




*. .* 


* YES 








* YES 




* YES 


1 








1 **** 
















» * 








1 








•—>* G2 * 








I 








* * 








V 








**** 








.*. 








• *. 








1 *. 








B2 *. 








ENDED *. 








• * ♦ • 









*****A5**» ******* 

* SET COMMENTS * 

* AND * 

* CONTINUATION * 

* INDICATORS * 

* * 
***************** 



n 



**** 

SCN10230 

*****B4*»* 

♦IEWLMLOG 

*-*—*—*—*— 



* SET * 
♦LEVEL INDICATOR* 

* TO ZERO * 

* * 
***************** 



*****D1 ********** 

* * 

* UPDATE PI * 
♦POINTER TO NEXT*— 

* COLUMN * 



***************** 



***** 
*JO * 
* H2* 



***************** 



****C4 ********* 

* * 

* RETURN * 

* * 
*************** 



->*.P1 AT COLUMN 



* THIS 

CHARACTER 
*. COMMA 



*****F2********** 

* * 

* SET 'ENDED * 
*BY A COMMA* IN * 

* STATUS * 

* * 
***************** 



* G2 *-> 

* * 
**** 

SCN10170 V 

*****G2********* 
* 

* SET 

* POINTER P2 ON 

* OPD 



*—*—*—*—*—*—*—*—* 
♦READ NEXT PARAM* 
♦ SET OPTION ♦ 
♦INDICATOR TO ♦ 
***************** 



***** 
*JO * 
* G4* 
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Chart JQ. READ8 Routine 



FROM CONTROL 

STATEMENT 

SCANNER 

•***A1 ********* 

* * 

* REA08 * 

* * 
*************** 



* SAVE * 

* 'STATUS' IN * 

* -OLD STATUS* * 

* * 
•*******•*•****•* 



*****C1 ********** 

* CLEAR * 

* WORK AREA * 
♦REFERRED TO BY * 

* POINTER P2 * 



* SET * 
•CHARACTER COUNT* 

* TO 9 * 

•***•****•**•**•* 



*****E1 ********** 

* RESET » 

* *AT LEAST ONE * 
» VALID * 

* CHARACTER* » 

* INDICATOR * 



* UPDATE PI * 
•POINTER TO NEXT*- 

* CHARACTER * 



SCN10230 

*****F3********** 
•IEWLMLOG NC* 



->«.P1 AT COLUMN 



***************** 



PI AT A 

BLANK 

•CHARACTER. 



SCN11050 

*****H1 ********** 

* SET * 

* *ENOED BY A * 

* BLANK* *<■ 

* INDICATOR IN ♦ 

* STATUS ♦ 
***************** 



SCN11040 



•AT LEAST *• 
ONE* 
.INDICATOR.* 
». SET .* 



— >».P1 AT A COMMA. 



SCN11010 

*****H3********** 

* SET » 

* 'ENDED BY » 

* COMMA* • 

* INDICATOR IN * 

* STATUS * 
***************** 

**** 

* * 

* J3 *-> 

•*** 

****J3* ******** 

* * 

* RETURN • 

* * 
*************** 

TO CONTROL 

STATEMENT 

SCANNER 



*****K3********** 

• * 

• UPDATE P2 * 
POINTER TO *<- 

•OTHER WORK AREA* 

• • 
*******•***••*••* 



n 



SCN11020 

*****G5********** 
•SET 'ENDED BY A* 

* LEFT » 
>* PARENTHESIS' » 

* INDICATOR IN * 

* STATUS » 
***************** 



L 



>* J3 * 

**** 

*****H5********»* 

• SET 'ENDED BY * 

• RIGHT * 
>* PARENTHESIS' * 

• INDICATOR IN * 

• STATUS * 
***************** 



L 



**** 
•>* J3 * 

**** 



*****J4********** 



->*.IS COUNT ZERO. 



***************** 



*****K4*«******** 

* SET • 

* *AT LEAST ONE * 
-• VALID • 

* CHARACTER* * 

* INDICATOR • 
***************** 



L 



•>* F3 * 

* * 
**** 
SCN11005 

*****K5********** 

• MOVE • 

• CHAR. AT PI * 
*INTO WORK AREA *<— 

• POINTED TO BY * 

• P2 * 
••**•••***••*•*•* 
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Chart JR. Include Processor (IEWLMINC) 



FROM 

INPUT 

PROCESSOR 

••••A3********* 

* * 

* IEWLMINC * 

* * 
*************** 



*****82********** 

* SET * 

* SINGLE BLOL *<■ 

* INDICATOR * 

***************** 



* HAS * 
INCLUDE 
POINTER 
CHANGED 



INCLU110 



.* WAS * 
.BLDL DONE ON 
*. LIST .* 



ARE 
ANY LEFT 
. IN LIST 



••***C5********** 

* GET * 
->* NEXT ITEM IN * 

* LIST * 

* * 
***************** 



.* IS SINGLE 

BLDL 

♦.INDICATOR. 



* PUT NAME * 
*IN SINGLE BLDL * 

* LIST * 

***************** 



*****03 ********** 

* * 

* FIND NEXT * 
•ITEM IN INCLUDE*<— 

* CHAIN * 



***» 
INCLU605 



•••••El ********** 

* PUT NAME IN * 

* BLDL LIST. * 

* UPDATE COUNT. * 
•UPDATE INCLUDE * 

* POINTER * 
***************** 



E2 *. 

••INCLUDE*. 

.* POINTER «« 

•.EQUAL INCLUDE. 

*. BREAK .* 

•POINTER* 

***YES 



n 



*****F2********** 



.* NEXT ». 
• ITEM *. 
INCLUDE WITH .* 
*. POINTER .* 



L 



INCLU450 

*****F3*****«*«*« 

* SET • 

* PS INDICATOR • 
•OPEN SYSLI8 OCB*— 

* FOR PS • 

* » 
***************** 



•05»**«*«« 
* » 

ISSUE FIND 

*********** 



• G3 * 

• * 
**** 



**** 

* * 

• F5 * 



•••••••***•**•*** 



>• K2 • 

» 
• *•» 



.* ANY ITEMS *. 
.LEFT IN BLDL . 
*. LIST .» 



n< 



»*»* v 




NCLU200 .*. 




G3 •. 




.* IS * 




ES .* IT LAST 












*• INCLUDE 




♦.CHAIN.* 





•*•• 

* * 

* G4 • 

* * 
• *** 



*«***H2********** 

* * 

* CLEAR 'MORE 
>* INCLUDES TO 

•COME' INDICATOR 



***************** 



L 



n 



>* J3 » • 



*****J2 *••*•♦•**• 
» SAVE * 
• POINTER » 
>* TO NEXT » 
» ITEM • 

*•**»••*• 



•*«««H3«********* 

• SET 'MORE * 

• INCLUDES TO • 
•COME' INOICATOR* 

• * 
**•«*•*•**•••**** 



* J3 *-> 

* * 

•*•* 

****J3********* 

* * 

* RETURN * 

* * 
•***•••*•****** 



*********** 



« ISSUE * 






YES •• END •• 


BLDL • 






■ ». OF INCLUDE .»<— 


• * 






*. CHAIN .« 


* * 






I *. .* 


*•***••**•• 






V ». .* 








**** * NO 








• 


* 1 **** 








• 


H2 • • • 








• 


» «— >* 03 * 








••*• * * 


V 






»«»• 


• *• 








H4 *. 






*****H5********** 


.• ». 






* IEWLMLOG * 


.* BLDL •• 


NO 




*—*-*-*-*-*-*-*-» 










>342 » 


. bUULtoarUL •* 








*• .* 






« FOR MEMBER • 


*• •* 






« NAMES FOUND * 


*• •* 






***•*•*•*••*•••*• 


* YES 
1 










1 
V 










**** 










• * 






V 


* C5 * 






• *• 


* * 






J5 •• 


***• ••*• 


.* ». 


• 




• 


YES .* ANY *. NO 


* 


C5 


•<- 


*. MEMBERS .« 








*. FOUND .* 




*** 


*. .* 








*. .* 
















•**• 








* * 








• F5 •<— i 








* * 








**** 1 NO 










•*K4******* 






K5 *. 


* * 






• * *• 


* OPEN * 






•* OPEN •• 










5SFUL •• 


3T5L1D rUK * 








* THIS DDNAME * 






*. .* 


* TYPORG=PD * 






*. .* 


*****<) 


****** 






*. 


• * 
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Chart JS. Automatic Library Call Processor (IEWLCAUT) 



**** 
* * 

* A3 *<— i 

* * 

• *** J 



* NEXT * 
ITEM IN LIST 
*. FOUND •* 



****A2 ********* 

IEWLCAUT 
*************** 



* B2 *-> 

* * 
**** i 



r\ 



* ISSUE FIND * 
FOR NEXT ITEM 

* IN LIST * 



**B3******* 

* • 

•OPEN DCB FOR 

* THIS DDNAME 

* TYPORG = PD 



********* 



****A4********* 

* * 

* RETURN * 

*************** 
**** 



**C4******* 

* 
->* ISSUE BLDL 



********** 



***************** 
**** 





*. END OF CESD 


V 


*. 


**** 




JT * 





*****D3 ******* 
* IEWLMLOG 

*-*—*—*—*—*—*— 



.* IS THIS * 
.DDNAME FOR A 
*. LIBRARY .* 



*E3** 
->*UPDATE POINTER 



**** 
* * 
->* D2 * 



IS POINTER 



* MARK ENTRY 
->*NULL, PLACE IT 
*IN HOLES CHAIN 



* G3 

**** 



n 



* INITIATE * 
♦PROCESSING THIS* 

* CHAIN * 

* * 

***************** 



* H2 *-> 



* TAKE * 

* NEXT ENTRY IN *<— 

* CHAIN * 



•END OF CHAIN 



INCLU670 .*. 

K2 *. 

*•** .* * 

* * NO .* MATCHED 

* H2 *< *. LIBRARY 

* * *. MEMBER 



* BLDL 

PREVIOUSLY 
♦.ATTEMPTED. 



INCLU170 

*****H3********* 

* ENTER 

* IN BLDL LIST, 

* SET BLDL 

* PREVIOUSLY 

* ATTEMPTED 
**************** 



*l LIST FULL I* 1 



•*** 
* * 

* B4 * 

* * 
**** 



.* ANY *. YES * * 

*. ITEMS IN BLDL.* >* B4 * 

*. LIST .* * * 

*. .* **** 



**•* 

* * 

* D2 * 
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Chart JT. Automatic Library Call Processor (IEWLCAUT) (Continued) 



***** 

»JT * 

* Al* 

* * 



**** 

* * 

* A2 * 

* * 
**** 



***************** 



->*. END OF CESD 



*****B2 ********** 

* * 

* * 
♦GET NEXT ENTRY * 



* G2 * 

* * 
**** 



****A4 ********* 



*************** 
TO ADDRESS 
ASSIGNMENT 
PROCESSOR 



***************** 



*.IT ER SUBTYPE. *- 



INCLU690 



.* IS IT *. 
->*• OVERLAY 

*. CONTROL .* 



*****C4********** 

* * 

* MARK ENTRY * 
->*NULL. PLACE IT *- 

*IN HOLES CHAIN * 

* * 
***************** 



**** 

* * 
->* A2 * 

* * 
**** 







1 

V 






**** 


V 


* * 


.*. 


* A2 ♦ 


D2 *. 


* * 


•* WAS *. **** 


**** 


* BLDL *. YES * * 




PREVIOULSY •* >* A2 * 




*.ATTEI» 


1PTED.* * * 





* MOVE * 

* NAME TO BLDL * 

* LIST * 

* * 
***************** 



.* *. **** 

.* BLDL *. NO * * 
*. LIST FULL .* >* A2 * 



**** | 

* * 

* G2 *->| 



*. SYSLIB OPEN 



**H2******* 

* * 
* 

* ISSUE BLDL 
* 

* * 
*********** 



* OPEN * 
->*STANDARD SYSLIB*- 

* TYPORG = PO * 
* * 

*********** 



*—*—*—*-*—*—*—*-* 
>* * 

* IEW0432 * 

* * 
***************** 



**** 

* * 

* A2 * 

* * 
**** 



***** 
*JS * 
* B2* 



110 



Chart KA. Address Assignment Processor (IEWLMADA) 



FROM INPUT 
PROCESSOR 
****A1 ********* 

* * 

* IEWLMADA * 
ft * 

*************** 



*****B1 ********** 

* CLOSE SYSLIB * 

* CLEAR ADDRESS * 

* ASSIGNMENT ♦- 

* COUNTERS AND * 

* INDICATORS * 
***************** 



->*. IN OVERLAY 



**** 

* * 

* Dl * 

* * 
**** 

I 
I 



ADA00400 .*. 



IN OVERLAY 



*****C2 ********** 

* COMPUTE * 

* SEGTAB LENGTH * 
♦AND BUILD A PC *- 

* ENTRY FOR * 
♦SEGTAB IN CESD * 
***************** 



*****D2 ********** 

* TEMPORARY * 

* LINKED * 
->* ADDRESSES ARE *- 

* FINAL LINKED * 

* ADDRESSES * 
***************** 



* ENTER SEG *- 

* NUMBERS IN * 

* CESD * 
***************** 



*****B4********** 

* * 

* SEARCH * 
>♦ TXTIOT FIND ♦- 

* CESD ENTRY * 

* * 
***************** 



ADA01100 

*****E1 ********** 

* SCAN SEG LGTH * 

* COMPUTE SEG * 

* RELOC CONSTS ♦— 
♦(START ADDR FOR* 

* EACH SEG ) * 
***************** 



*****E2 ********** 

* * 
♦PROGRAM LENGTH * 

>* EQUALS LENGTH ♦- 
♦OF LONGEST PATH^ 

* * 
***************** 



*****D3* ********* 

* TEMP REL * 

* CONSTS ARE * 
>♦ FINAL ♦- 

* RELOCATION * 

* CONSTANTS * 
***************** 



*****E3* ******** 
* 

* SCAN CESD AND 
->*UPDATE ADDRESS 

*OF EACH SD, PC, 

* OR CM 
**************** 



*****04 ********** 

* * 
♦PROGRAM LGTH IS* 

->^EQUAL TO LENGTH*- 

* OF SEGMENT 1 ♦ 

* * 
***************** 



*****E4 ********** 

♦ DURING SCAN, ♦ 

♦ COMPUTE FINAL ♦ 
->*RELOC CONST FOR^ 

♦SD, PC, CM AND ♦ 

♦ PUT IN RCT ♦ 
***************** 



ADA00550 V 

*****F4 ********** 

♦ UPDATE ♦ 

♦ LR ADDRESSES ♦ 

♦ USING RELOC ♦ 

♦ CONST OF SD, ♦ 

♦ PC, OR CM ♦ 
***************** 



ADA00123 

*****B5********** 

♦ ASSIGN ♦ 

♦ TEMP LINKED ♦ 
>^ADDR TO EACH SD^ 

♦ OR PL LINE OF ♦ 

♦ CESD ♦ 
***************** 



*****C 5*** ******* 
♦ COMPUTE ♦ 
♦TEMPORARY RELOC^ 
♦CONST FOR EACH * 
♦CONTROL SECTION^ 
♦SAVE RC IN RCT ♦ 
***************** 



***** 05* ********* 

♦ * 
♦ACCUMULATE SEG ♦ 

♦ LENGTH AND ♦ 
♦ENTER IT IN SEG^ 

♦ LGTH TABLE ♦ 
***************** 



*****E5********** 

♦ ASSIGN ♦ 

♦ PENDING TEMP ♦ 
♦LINKED ADDR TO ♦ 
♦NO-TEXT CSECTS,^ 

♦ ENTAB, CM ♦ 
***************** 



*****F5********** 

♦ IF PR ASSIGN ♦ 
♦DISPLACEMENT IN^ 

♦ CESD AND ♦ 

♦ ACCUMULATE ♦ 
♦TOTAL PR LENGTH^ 
***************** 



I 

I 
ADA00900 V 

*****G1 ********** 
♦WRITE OUT ERRORS 
♦MESSAGE FOR ANY^ 

♦ UNRESOLVED ♦ 

♦ EXTERNAL ♦ 

♦ REFERENCES ♦ 
***************** 



*****H2********** 

* * 

* PROGRAM IS ♦ 
>♦ EXECUTABLE ON ♦ 

♦LET OPTION ONLY^ 

* * 
***************** 



♦ SET MARKED ♦ 

♦ CESD ITEMS TO ♦— 

♦ NULL TYPE ♦ 

♦ * 
t******* 



********* 



ADA00700 

*****J3********** 

♦ IEWLMENT ♦ 
*—*—*—*—*—*—*—*—* 

>* COMPUTE ENTRY ♦- 

♦ PT AND BUILD ♦ 

♦ ALIAS TABLE ♦ 
***************** 



**** J4** ******* 

♦ TO ♦ 
->♦ INTERMEDIATE ♦ 

♦ PROCESSOR ♦ 
*************** 
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Chart KB, IEWLMENS 



FROM ADDRESS 
ASSIGNMENT PROCESSOR 
****A2********* 

* * 

* IEWLMENS * 



* SCAN CESD FOR * 

* LABEL * 

* REFERENCES * 

* * 
***************** 

I 



*****C2 ********** 

* USING ID OF * 

* ID LENGTH * 
♦FIELD, REFER TO* 
*SO OR PC ENTRY * 

* IN CESD * 
***************** 



*****02 ********** 

* * 

* INSERT * 
*SEG NO. IN CESD* 

* FOR LR * 

* * 
***************** 



*. IN OVERLAY 



*****F2********** 

* SCAN * 

* CALL LIST * 
♦ENTERING CHAIN * 

* POINTERS * 

* * 
***** 



********** 



G2 *. 
.* ANY *. 

.*CALLS FROM *. 
*.SEG NO. 1 TO . 
*.ANY OTHER.* 
*. SEG 



• * 
* YES 



>* PROG IS * 
* EXECUTABLE ON * 
*LET OPTON ONLY * 
***************** 



*****H2 ********** 

* * 

* DETERMINE * 
♦NUMBER OF ENTAB* 
♦LINES FOR EACH ♦ 

* SEGMENT ♦ 
***************** 



*—*—*—*— 



-*—*-*-* 



♦ MAKE ONE CESD ♦ 
♦ENTRY FOR ENTAB* 

* PER SEGMENT * 
***************** 



****K4********* 

RETURN * 

*************** 
TO ADDRESS 
ASSIGNMENT 
PROCESSOR 
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Chart KC. Entry Processor (IEWLMENT) 



FROM ADDRESS 

ASSIGNMENT 

PROCESSOR 

****A2 ********* 

* * 

* IEWLMENT * 
x- * 

*************** 



ENT00150 V 

*****B 2 ********** 

* * 

* FIND NEXT * 

* CHAINED ALIAS * 

* ENTRY IN CESD * 

* * 
***************** 



*****C2 ********** 

* MOVE * 

* CHAINED ALIAS * 

* SYMBOL FROM * 

* CESD TO ALIAS * 

* TABLE * 
***************** 



ENT00190 V 

*****D2********** 

* * 

* SCAN CESD * 

* FOR MATCHING * 

* ALIAS SYMBOL * 

* * 
***************** 



* SYM * 
MATCH FOUND 



*****E3********** 

* * 
*ENTER ESDID OF * 

->* CHAINED ALIAS *- 
♦SYMBOL IN ALIAS* 

* TABLE * 
***************** 



*****E4********** 

* SET * 

* TYPE FIELD OF * 
->* ALIAS SYMBOL *- 

* ENTRY IN CESD * 

* TO 'NULL* * 
***************** 



*****F2 ********** 

* ENTER * 

* ESDID OF ZERO * 
*IN ALIAS TABLE * 
♦FOR THIS ENTRY * 

* * 
***************** 



*****E5********** 
♦PUT ADDRESS OF * 
♦SD OR LR ENTRY ♦ 
->* FOR ALIAS IN ♦ 
♦CESD ENTRY FOR ♦ 
♦ ALIAS SYMBOL ♦ 
***************** 



*****F5********** 

♦ PUT ESDID OF ♦ 
♦CONTROL SECTION* 
♦OF ALIAS SYMBOL* 

♦ IN CESD ENTRY ♦ 

♦ FOR SYMBOL ♦ 
***************** 



ENT00160 .♦. 






ENT00200 .*. 






G2 ♦• 






G3 *• 






• * *• 




.* *. 




YES .* ANY 


*. 


NO 


.* IS THERE 


*. 


NO 


*. ENTRIES .* 




*. POINT .* 


' 1 


*. .* 






*• •* 




i 


*. •* 






*. .* 




V 


* 






* YES 

1 

V 

***** 

*KD * 

* A2* 

* * 




***** 

*KD * 

* A5* 

* * 

* 
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Chart KD. Entry Processor (IEWLMENT) (Continued) 



***** 

♦ KD * 

* A2* 



***** 
*KD * 
* A5* 



*. SYMBOLIC E.P. 



->*.E.P. RELATIVE. ♦- 



* SCAN CESD * 
♦FOR MATCHING SD* 

* OR LR SYMBOL * 

* * 
***************** 



*****83********** 

* USING ESDID * 

* FROM END CARD * 

* LOCATE REL * 
♦CONST FOR C.S. * 
♦CONTAINING E.P.* 
***************** 



*****A4 ********** 
* USING ESDID ♦ 
*FROM END CARD. * 
->♦ POINT TO CESD * 
♦ENTRY FOR C.S. * 
♦CONTAINING E.P.^ 
***************** 



*****B 4** ******** 

♦ ADD CONTROL ♦ 
♦SECTION ADDRESS^ 

♦ TO ASSEMBLER ♦ 

♦ ASSIGNED ADDR ♦ 

♦ IN END CARD ♦ 
***************** 



V 






.♦. 


V 


C2 ♦. 


*****C3 ********** 


.♦ ♦. 


♦ ADD REL ♦ 


.♦ ♦. 


♦ CONST TO ♦ 


♦.SYMBOL FOUND .♦ 


♦ ASSEMBLED ♦ 

♦ ASSRESS (FROM ♦ 


♦• •♦ 


♦ . .♦ 


♦ END CARD) ♦ 


♦ . .♦ 


***************** 


♦ YES 


1 


L 


i 
V 



ENT01250 V 

*****A5*^^**^**** 
♦SCAN CESD FOR A* 
♦CONT SECT (SD. ♦ 
♦PC-NOT DELETE) ♦ 
♦ WITH LOWEST ♦ 
♦ASSIGNED ADDR. ♦ 
***************** 



ENTRY FOUND 



ENT00800 



D2 



♦ . 



*—*—*—*- 



—*—*—*—* 



♦ INVALID ♦< 

♦ ENTRY ♦ 

♦ POINT ♦ 
***************** 



IS 

.♦ ENTRY PT ♦ 

•CONT SECT IN 

♦. SEGMENT .♦ 

♦.NO. l.^ 

♦• •♦ 

♦ YES 



♦ INVALID ♦ 

♦ ENTRY ♦ 

♦ POINT * 
***************** 



ENT00900 V 

*****E2 ********** 

♦ SAVE ♦ 
♦E.P. ADDR SAVE ♦ 

♦ ESDID OF C.S. ♦ 
♦CONTAINING E.P.^ 

♦ * 
***************** 



ENT0100 

V 
****F2 ********* 

* * 

* RETURN ♦ 

* * 
*************** 



TO ADDRESS 
ASSIGNMENT 
PROCESSOR 
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Chart LA. Intermediate Output Processor (IEWLMOUT) 



FROM 
ADDRESS 
ASSIGNMENT 
**A2********* 



->*.MAP SPECIFIED. 



* B3 * 

# * 

**** 



->».RLDS IN CORE .* 



* 




» 


JT00105 V 

*****B3********** 
* IEWLMMAP * 




B3 * 

• 


->* 

* 
* 


PRODUCE MAP 
OR XREF 


• 
* 



******C4 *********** 

* WRITE OUT * 
-> CESD ON 

* SYSLMOD * 



•****03********** 

* * 

* BUILD HESD * 



TEXT 
IN LOAD 
MODULE 



—*—*—*—*—*—* 



>* NO TEXT *— 

* IN LOAD * 

* MODULE * 

***************** 



****E5********* 

* TO FINAL * 

* PROCESSOR * 

* * 
*************** 



OUTOIOOO .* 



*F5*********** 

*BUILD AND WRITE* 

> OUT SEGTAB 

* CONTROL * 

RECORD 

************* 



******G1 *********** 

WRITE 

* OUT * 

SCATTER/TRANS <— 

* RECORDS * 

************* 



* BUILD SCATTER * 
-*AND TRANSLATIONS— 

* TABLES * 

* * 
***************** 



• *IS PROGRAM *. 
.TO BE SCATTER. 
*. LOADED .* 



******G5********* 

* BUILD 

AND WRITE OUT 
* SEGTAB * 

************* 



OUT00560 

******H3*********** 

READ 

* TXT AND RLD * 

NOTE LISTS 

* INTO MAIN * 

STORAGE 



*****J3********** 

* MARK SO. PC * 
♦WITH HIGH ESDID* 
*IN PROGRAM (OR * 

* EACH SEG WITH * 
*TXT IF OVERLAY)* 



*****K3********** 

* SAVE HIGHEST * 

* SEG NO. OF * 

* SEGMENTS THAT *— 

* CONTAIN TEXT * 

* * 
***************** 



•***K5********* 

* TO SECOND * 

* PASS * 

* PROCESSOR * 

*************** 



***************** 
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Chart LB. MAP/XREF Processor (IEWLMMAP) 



**A2****** 
IEWLMMAP 



* A4 

* 

***4 

MAP13 
YES 



n 



RLO TYPE PR 



*****B2****»****« 

* * 

* INITIALIZE, * 
*6ETMAIN. PRINT * 

* HEADER. OPEN * 

* SYSLMOO * 
***************** 



r 



♦.RLD TYPE PR2 



* IS CESD 

TYPE NEVER 
*. CALL 



*****B5********** 

* * 

* INDICATE * 
♦•NEVER CALL* ON* 
*MAP PRINT LINE * 

* * 
******* 



c, n 



r 

V 

**** 

* E2 * 
***• 



*****D1 ********** 

* REINITIALIZE * 

* REGISTERS. *— 
» INCREMENT * 

* SEGMENT NO. * 

***************** 



****£! *********** 

WRITE OUT 

PR'S CUML. * 

LENGTH. E.P. 

* ADDR. TOTAL * 

LENGTH 

************* 



****F 1 ********* 

* * 

* RETURN * 

*************** 

TO FINAL OR 

INTERMEDIATE 

OUTPUT PROCESSOR 



******D2*********** 

READ CESD 

* AND FIRST * 

CONTROL 

* RECORD FROM « 

SYSLMOD 



>* GATHER CESD * 
* ENTRIES FOR * 
•PRESENT SEGMNT * 
**•*•******••**** 



*****F2********** 

* * 
♦SORT ASSEMBLED * 

* CESD ENTRIES ♦ 
♦USE ADDRESS AS ♦ 

* KEY ♦ 
***************** 



♦ CREATE ♦ 

♦ MAP FOR THIS ♦ 

* SEGMENT ♦ 

* * 
***************** 



**** 
♦ CI ♦<- 

**** 



*****C3********** 

♦ SAVE ♦ 

♦ CUMULATIVE ♦ 

♦ LENGTH VALVE ♦ 



**#**C5********** 

♦ INDICATE ♦ 
-♦•UNRESOLVED* ON^<— 

♦MAP PRINT LINE ♦ 

* * 
***************** 



* K3 * 
**** 



n 



******F4 *********** 

♦ PASS ♦ 

OVER TEXT 

♦ RECORD ♦ 

************* 



******G4* 



********* 



************* 



•*** 

* * 

♦ J2 ♦ 



♦ INITIALIZE ♦ 

♦ FOR LOOP OF ♦ 

♦ CESD AND RLD ♦ 

♦ * 
***************** 



***************** 



ENTRY 


♦ . 


FROM 




FINAL 




• ♦ 


♦• •♦ 




♦ NO 




| »*** 


* 




L_>* 


Cl 


* 




•*** 



* * E4 ♦ 
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Chart MA. Second Pass Processor 



****A2*» ******* 

* * 

* IEWLMSCD * 

* * 
*************** 



»****B2 ********** 

* * 

* * 
•INITIALIZATION * 

* * 

* * 
***************** 



•* ANY TEXT *. NO 

*. READY TO BE .* 

♦.PROCESSED.* 



*• •* 

* YES 
I 



>* DETERMINE * 

* ID-MULT TO * 

* PROCESS * 
***************** 



LOOKAHED .*. 



.* NEXT 
*. READY 
♦.PROCE 
*. 

*• 


TEXT *. NO 


*-*— *— *— i 


»—*-*—*- 

3MINE 

3-MULT 

DCESS 

******** 


ESSED.* 
.* 

• * 


* NEXT It 

* TO PR( 

********4 


* YES 














V 
RLDSCAN .*. 

E2 *. 
.* *. 
.* ANY *. NO 

*. RLD f S FOR .* 

*. TEXT .* 
*. .* 


V 
***** 




*• 

1 


• * 
* YES 


*MB * 

* CI* 

* * 






* 





.* PREV- *. 
.♦IOUS CONTRL*. YES 

♦RECORD READY TO* 

*BE WRITTEN.* 



*****F3********** 

* WRTCRRLD * 
*—*—*—*—*—*-*—*-* 

>* SET UP AND * 
♦WRITE PREVIOUS * 

* CONTROL RECRD * 
***************** 



*****G3********** 

* RDRLD ♦ 
*—*—*—*—*—*—*-*-* 

>♦ SET UP AND *< 1 

* READ NEEDED * | 

* RLD'S * 
***************** I 



*MA * 
* G3* 
***** 



* RELOCATE * 
♦ADCONS OF CUR- * 

* RENT ID-MULT * 
***************** 



**** 
MVRLD 

*****J2 ********** 

* * 
♦MOVE RELOCATED ♦ 

* RLD'S TO RLD * 

* OUTPUT BUFFER * 

* * 
***************** 



***** 
*MB * 
* Al* 



Section 3: Program Organization 117 



Chart MB. Second Pass Processor (Continued) 



***** 

*MB * 
* Al* 



.* RLD 

OUTPUT 
*. BUFFERS 
*.FULI_ .* 



A3 *. 

.* ONE *. 

.* BUFFER * 

— >*CONTAINS PREV. 

*. CONTROL .* 

♦RECORD.* 

*• •* 

* NO 



>* SET UP AND 
♦WRITE PREVIOUS 
* CONTROL RECRD 



*********** 



MORE 
RLD'S FOR 
. TEXT 



♦ CI *->j 



♦ LAST ♦. 
TEXT IN GROUP. 

♦ . .* 

♦ . •♦ 
♦ YES 


NO 






V 

♦MA * 
♦ C2^ 



.* PREVIOUS *. YES 

.WRITE A DUMMY.* 

*. WRITE .* 



.♦ MORE * 
•RLD'S NEEDED 
♦.FOR TEXT .♦ 



♦ SET UP AND 
♦WRITE TXT REC. 

* IF NEEDED 
*************** 



WRTCR RLD 



>♦ SET UP AND 
A ♦ WRITE AN RLD 
♦ RECORD 



.* PREVIOUS ♦. 

♦CONTROL RECORD. 

♦. WRITTEN .* 



>♦ SET UP AND 
♦WRITE PREVIOUS 
♦CONTROL RECORD 
**************** 



♦ SET UP AND ♦- 

♦ ISSUE DUMMY ♦ 

♦ WRITE * 
***************** 



.♦ PREVIOUS ♦. YES 

•WRITE A DUMMY.* 

♦. WRITE .♦ 



>♦ SET UP AND 

* ISSUE XDAP 

* WRITE 
************** 



SETUP AND ♦ 

WRITE TEXT * 

RECORD ♦ 

*************** 



.♦ MORE THAN 
ONE RLD 
♦.BUFFER IN. 
*. USE .♦ 



>♦ SET UP AND ♦ 

* WRITE AN * 

♦ RLD RECORD ♦ 
***************** 



TSTSGEND 



***** 
♦MA ♦ 
* C2* 



•****H3********** 

♦ * 

♦ SET 'END OF ♦ 

♦ MODULE* IN ♦- 
♦CONTROL RECORD ♦ 

***************** 



♦.ENTAB NEEDED 



* ANY RLD'S * 

STILL TO BE 
♦. WRITTEN .♦ 



SGEND2 

*****J4 ********** 

* SET ♦ 

* 'END OF ♦ 
->* SEGMENT* IN ♦— 

♦CONTROL RECORD ♦ 

* * 
***************** 



>♦ SET UP AND 

♦ WRITE A CON- 

♦ TROL RECORD 
*************** 



*****K i ********** 

* SCDEDTAB ♦ 
*—*—*—*—*—*—*—*—* 

* ENTAB-ENTAB *— 

* RLD CREATION ♦ 

* * 
***************** 



.♦ ANY *. 
* MORE ♦. 

SEGMENTS TO .* 
*. PROCESS .♦ 



****K3********^ 

♦ * 

♦ TO FINAL * 

♦ PROCESSOR * 
*************** 
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Chart MC. GETIDMUL Routine 



****A2* ******** 
ft « 

* GETIDMUL * 
ft * 

*************** 



V 
.*. 

B2 *• 

•SEARCH TXTIOT. 

*. FOR NEXT .* 

♦ID-MULT TO.* 

♦PROCESS* 

*. .* 



C2 *. 
.* *. 

.* *. N 

*. ID-MULT FOUND. *- 

*. .* 

*. .* 

*. .* 

* YES 



*. ID-MULT IN 
*. CORE 



*****C3********** 

* SET UP * 

* CONTROL BLOCK * 
->* TO REFLECT NO *- 

* LOOK-AHEAD * 

* * 
***************** 



IDMUL190 .*. 
D3 * 



.* WILL *. YES 

->*. RECORD FIT IN.* 

*. BUFFER .* 

*. .* 

*. .* 



****C4 ********* 

* * 
->* RETURN * 

* -ft 
*************** 



*****D4 ********** 

*RDTXT * 

*—*—*—*—*—*-*—*—* 

->* SET UP AND * 

* READ NEEDED * 

* TEXT * 
***************** 



E2 *. 

.* *. 
ft ft 

SCTR OR DC 

ft. .ft 

*. .* 

*. .* 

* NO 



F2 



*. 



•*CAN ID-MULT*. NO 

*.BE GROUPED IN.* 

*. PREV. .* 
*. GROUP.* 
*. .* 
* YES 



*****P3********** 

* SET * 

* UP CONTROL * 
->* BLOCK TO *- 

* REFLECT NEW * 

* GROUP * 
***************** 



****F4 ********* 

* * 
->* RETURN * 

* ft 
*************** 



*****G2********** 

* SET UP * 

* CONTROL BLOCK * 

* TO REFLECT * 

* CONTINUED * 

* GROUPING * 
***************** 



****H2 ********* 

* * 

* RETURN * 
ft * 

*************** 
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Chart MD. TXT/RLD Read Routines 



****A1 ********* 

* * 

* ROTXT * 

* * 
*************** 



•***A4********* 

* * 

* RDRLD * 

* * 
*************** 



ANY 
UNCHECKED 
- TEXT 
*. READS.* 



******C1 *********** 

* * 

READ 



******B2********* 

* 
-> CHECK 

* * 

************* 



ANY *. YES 

UNCHECKED •* 

. READS .* 



**** 

* * 

* C4 *-> 

* * < 

**** 

V 
******C4 *********** 

* * 
READ 



******B5*********** 

* * 

-> CHECK 

* * 

************* 



************* 



************* 



*****01 ********** 



******D4** ********* 



***************** 



********* 



120 



*****E4********** 



***************** 



****F 1 ********* 

* * 

* RETURN * 

* * 
*************** 



RDRLD150 



.* ANY MORE 

*. RLD'S FOR 

*. TEXT 



****F5********* 

* * 

* RETURN * 

* * 
*************** 



**•* 

* * 

* C4 *<- 

* * 
**** 



ROOM IN 

RLD INPUT 

. BUFFER . 



*****J4********** 

* * 

* INDICATE * 

* MORE RLD'S TO * 

* BE READ * 

* * 
***************** 



****K4********* 

* * 

* RETURN * 

* * 
*************** 



Chart ME. WRTTXT Routine 



•***A1 ********* 

* * 

* WRTTXT * 

* * 
*************** 



.* PREVIOUS *. YES 

♦•WRITE A DUMMY.* 

*. WRITE .* 



FIRST 
TEXT OF 
SEGMENT 



*********** 



* SAVE RELATIVE * 
->* TRACK ADDRESS * 

* IN TTR TABLE * 

* * 
***************** 



******B3*********** 

* * 

> WAIT 

* * 

************* 



•***B5»******** 

• * 

* RETURN * 



•***C4 ********* 

* EXIT 

* ERROR ROUTINE 



•* ANY *• YES 

*. UNCHECKED .* 

*. WRITES •* 



»*****E1 *********** 

* * 

WRITE 

* * 

************* 



******D2*********** 

* * 

-> CHECK 

• * 

************* 



*****F2********** 



***************** 



•* FIRST *. N 
♦.TEXT OF LOAD .*- 
*. MODULE .* 



****G2 ********* 

* RETURN 

* 
*************** 



•****H1 ********** 

* PUT * 

* NEEDED * 
♦INFORMATION IN * 

* PDS * 

* * 
***************** 
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Chart MF. Relocation Routine (IEWLMREL) 



****A2********* 

* * 

* IEWLMREL * 

* * 
*************** 



RELOCATE V 

*****B2********** 

* CALCULATE * 

* ADDR. AND * 
•EXTENT OF RLD'S* 
*IN INPUT BUFFER* 

* * 
***************** 



*****C2 ********** 

* * 

* SAVE R * 
•POINTER; UPDATE* 

* TO FA FIELD * 

* * 
***************** 

**** 
*MF * 

* D2 *-> 



*****D1 ********** 

* * 

* UPDATE * 

* TO NEXT RLD *— 

* ITEM * 



REL0C150 

*****D3********** 

* UPDATE * 

* LOW * 
>*MULTIPLICITY OR*- 

* MARK ENTRY * 

* 'PROCESSED* * 
***************** 



.* MORE 
->*. NEEDED RLD* 
*.IN GROUP 



.♦NEEDED *. 
.* RLD'S IN * 
->*. OTHER BUFFER 



*****E1 ********** 

* * 

* UPDATE LOW * 

* MULT. IF IN *< 

* HIGHER MULT. * 

* * 
***************** 



* RLD * 

WITHIN TEXT 
*. LIMITS .* 



****E5*«* ****** 

* * 

* RETURN * 

* * 
*************** 



*****F2********** 



*************** 



INVALID 

TWO-BYTE 

ADCON 



*—*-*—*—*—*—*—*-* 
->*SET BIT MAP TO *- 
•INDICATE INVALD* 
* 2-BYTE ADCON * 
***************** 



SPLIT ADCON 



***************** 



.* ADCON *. 
. REQUIRES 
♦.DELINKING.* 



*****J3********** 

* OBTAIN DELINK * 

* VALUE AND * 
>* CORRECT R * 

* POINTER FOR * 

* RELOCATION * 
***************** 



.♦ IS THIS 
*. AN OVERLAY 
♦. MODULE . 



♦ . •* 
* YES 
*•** 
*MH * 
->* Al * 



L 



***** 

*MG ♦ 
♦ Al* 
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Chart MG. Relocation Routine (IEWLMREL) (Continued) 



***** 

*MG * 
* Al* 



*****A1 ********** 

* * 

* MOVE AOCON * 

* FROM TEXT TO * 

* WORK REGISTER * 



********* 



(******* 



RELOC130 



.* IS *. YES 

->*. RLD TYPE PR .♦ 

*. TYPE2 .* 



.♦HESD ENTRY 
*. FOR ADCON 
♦. MARKED . 
*- NEG .* 



*****01 ********** 

* * 

* MAKE IT A * 

* FOUR-BYTE * 
♦NEGATIVE NUMBER* 

* * 
***************** 

**** 



*****E1 ********** 

♦ PERFORM ♦ 

♦relocation: add^ 

♦ or subtract ♦ 

♦ reloc. factor ♦ 

♦ * 
***************** 



RELOC100 

*****F 1 ********** 
♦MOVE RELOCATED * 

♦ ADCON BACK ♦ 

♦ INTO TEXT ♦ 

♦ RECORD ♦ 

♦ * 
t********** 



****** 



♦ Gl *-> 

♦ * 
**** 

*****G1 ********** 

♦ * 

♦ RELOCATE ♦ 

♦ ADDRESS FIELD ♦ 

♦ OF RLD ITEM ♦ 

♦ * 
***************** 



*****B3********** 

♦ INSERT ♦ 

♦ CUMULATIVE PR ♦ 
>♦ LENGTH INTO *— 

♦VALUE OF ADCON ♦ 

♦ * 
***************** 



*****C3**« 



t****** 



♦ ADD OR ♦ 
->^SUBTRACT DELINK^ 

♦ VALUE ♦ 

♦ * 
***************** 



*****E2 ♦♦**♦♦**♦* 
♦TYPE IS BRANCH ♦ 
♦ OR PR TYPEi; ♦ 
♦INSERT ABSOLUTE^ 
♦REL. FACTOR FOR^ 
♦VALUE OF ADCON ♦ 
***************** 



♦. SPLIT ADCON 



**** 

♦ MG ♦ 

♦ J I ♦-> 



♦♦♦♦♦^♦♦♦♦♦♦♦♦♦* 

♦ ♦ 

♦ SAVE RLD ♦ 
>♦ ITEM IN HESD ♦ 

♦ PREFIX ♦ 



******** 



******* 



«*** 
RELOC120 

*****jl********** 

♦ ♦ 

♦ UPDATE ♦ 

♦ TO NEXT RLD ♦ 

♦ ITEM ♦ 

♦ ♦ 
***************** 



***** 
♦MF ♦ 
♦ D2^ 
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Chart MH. Relocation Routine (IEWLMREL) (Continued) 



* IS IT 

A V-TYPE 
*. ADCON 



***** 
*M6 * 
* Al* 



* ADCON* S * 

LENGTH FOUR 
*. BYTES .* 



SET BIT MAP 

TO REFLECT 

INVALID V-TYPE 



.♦THE ADCON'S*. 
. SYMBOL 
♦UNRESOLVED.* 



*****D 1 ********* 

♦OBTAIN SEGMENT 
* NUMBER OF 
♦CALLED SEGMENT 



*****E1 ********** 

* * 
♦OBTAIN SEGMENT ♦ 

♦ NUMBER OF ♦ 
♦CALLING SEGMENT* 



♦ FIND COMMON ♦ 
♦SEG, WITH HIGH-* 

♦ EST SEG NO. ♦ 



IS IT 
AN UPWARD 
. CALL 



♦ IS IT *. YES 

A DOWNWARD .« 

*. CALL .♦ 



.♦IS IT A*. 
♦ LATERAL ♦ 

CALL ACROSS 
♦. REGIONS .♦ 



CREATE 

NEW ENTRY IN 

ENTRY LIST 



ALLOWABLE 
•EXCLUSIVE. 
♦.CALL .* 



*****K 3* ********* 



♦CHANGE VALUE OF* 

->*V-TYPE ADCON TO*— 

•POINT TO ENTAB * 

ENTRY 



••••A************ 



****H5********* 

* * 

* RETURN * 



***************** 



***** 
*MG * 
* Gl* 



124 



Chart NA. Final Processor 



FROM INTERMEDIATE 
OUTPUT OR SECOND 
PASS PROCESSOR 



OVLY 

OPT I ON 

•SPECIFIED. 



WRITE TTR 
LIST FOR 
SEGMENTS 



»****B4 ********** 

* PLACE * 
*TTR OF OVERLAY * 

->*TTR LIST IN PDS* 

* DIRECTORY * 

* * 
***************** 



*****C2********** 

* PLACE * 
•MEMBER NAME IN * 

* PDS DIRECTORY *- 
•FROM NAME CARD * 

* OR DEB * 
••*****•****•••** 



*«***C3********** 

* SET UP C-BYTE * 

* OF DIRECTORY * 
>* FOR * 

* BLOCK/SCATTER * 

* FORMAT * 



**** 
ENTRY FROM *NA * 
IEWLMLOG TO* D2 
TERMINATE * * 

**** 
FNL301A 



n< 



**02******* 

* STOW * 
DIRECTORY 

WITH ADD OR 
REPLACE AS 

* DIRECTED * 



->*. ANY ERRORS 



*—*—*—»—»—*-*—*_ 
>* LOG ERROR 

* TYPE AND 

* MESSAGE 

**************** 



'>-\< 



* ANY * 

ALIAS TO BE 
*. STOWED .* 



F2 *. 
.* HAVE *. 

••ATTRIBUTES *. 

•CHANGED SINCE. 

*. START OF .* 

••EDIT •* 

***NO 



*****E3 ********* 

* SAVE 

* MAIN MEMBER 
->*NAME AND ENTRY 

* POINT PUT IN 

* ALIAS 



*****F3*««*«*««** 

•PRINT IMAGE TO * 
>* NOTIFY OF * 

* CHANGED * 

* ATTRIBUTES * 



••RENT OR». 
.* REUS «. YES 
->*. ATTRIBUTES ON.» 



*****E5»* ******** 
» SAVE MAIN • 
•MEMBER NAME AND* 



ENTRY FROM *NA 
IEWLMINP TO* G2 
TERMINATE * 



r 



*****F4********** 

* PICK UP * 

* ALIAS E.P. * 
•(EITHER DEFINED* 

* OR USE MAIN * 

E.P.) 
***************** 



**G4******* 

•STOW ALIAS IN* 

PARTITIONED 

* DATA SET * 

* DIRECTORY * 



GO TO PRINT 

DIAGNOSTIC 

DIRECTORY 



->*.END OF INPUT 



ANY ERRORS 



>* LOG ERROR 

* TYPE AND 

• MESSAGE 
************** 



* REPOSITION * 

• INTERMEDIATE * 

•FILE (SYSUT1 )* 

*********** 



**J3******* 

* * 

* * 

•CLOSE ALL FILES* 



*****K3********* 

* SET UP 
•CONDITION CODE 

* INDICATING IF 

• NEXT STEP IS 

• EXECUTABLE 



***** j 4. ********** 

* GO TO PRINT * 
•ALIAS NAME WITH*- 

* MESSAGE * 
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Chart NB. SYNAD Routine 



THIS FROM *. 
SYSLIN OR . 
.SYSLIB 6 .* 
♦.FIXED.* 



*****B3********** 



****B5********* 
* RETURN * 



• *** 
* * 
->* F3 * 



**C2******* 



* NO 

L*»»* 
>* F3 



*****04 ********** 

* SET BIT * 

* INDICATING * 
>* ERROR WHILE * 

•READING SYSLMOD* 

* * 
***************** 



************ 



* F3 *-> 



*****F2 ********** 
♦INSERT' IEW0L30^* 
♦IN MESSAGE. SET* 

* BIT IN APT ♦<- 

* FOR BIT MAP ♦ 

* PROCESSOR ♦ 



ERROR 
READING 
SYSLMOD 



*****F4********** 

* INSERT * 

* • IEWL0294* IN * 
->*MESSAGE SET SIT* 

* IN APT OR BIT * 

* MAP PROCESSOR * 
***************** 



MOVE 

MESSAGE TO 

PRINT BUFFER 



PRINT MESSAGE 



************** 



*****J3********** 
* * 

♦SYNADRLS MACRO ♦ 



****K2 ********** 
TURN OFF BIT * 
INDICATING * 
ERROR WHILE *<■ 

READING SYSLMOD* 



ERROR 
READING 
SYSLMOD 



****K4********* 

* * 

* EXIT TO ♦ 
♦FINAL TO ABORT ♦ 

*************** 
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Chart NC. ERR. Logging RTN-IEWLMLOG 



****A2 ********* 

* * 

* IEWLMLOG * 

* * 

*************** 



**** 

* * 

* B4 * 

* * 
**** 



*****B2 ********** 

* * 
♦SEPARATE ERROR * 

* CODE AND * 
♦MESSAGE NUMBER * 



******** 



t******** 



***************** 



WRITE 

OUT CARD 

* IMAGE * 

************* 



****01 ********* 

* * 

* RETURN * 

* * 
*************** 



YES .* CONTROL * 

*. STATEMENT TO 

*.BE LISTED.* 



♦.SEVERITY CODE. 



***** 
*NA * 
* D2* 
* * TO FINAL 
* PROCESSOR 



.* CESD * 
.SYMBOL TO BE 
*. WRITTEN .* 
*. OUT .* 



*****E2** ******** 

* * 

* MOVE SYMBOL * 

* TO MESSAGE * 

* BUFFER * 



********** 

I 



IS THERE 
A SECOND 
. SYMBOL 



*****G2 ********** 

* * 

* MOVE SECOND * 

* SYMBOL TO * 
♦MESSAGE BUFFER * 

* * 
***************** 



****04** ******* 

* * 

* RETURN * 

* * 
*************** 



WRITE 
OUT MESSAGE 
BUFFER * 

************* 
I 
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SECTION 4: MICROFICHE DIRECTORY 



The microfiche directory is designed to 
help you find named areas of code in the 
program listing , which is contained on 
microfiche cards at your installation. 
Microfiche cards are filed in alphameric 
order by object module name. If you wish 
to locate a control section, entry point, 
table, or routine on microfiche, find the 
name in column one and note the associated 
object module name. You can then find the 
item on microfiche, via the object module 
name; for example, the Alias Table is on 
card IEWLMENT. The other columns provide a 



description of the item, its flowchart ID 
(if applicable) , its overlay segment numb- 
er, and a synopsis of its function (or its 
contents, if a table) . 



This section also contains: 

• A CSECT-module cross-reference table. 

• Diagrams of the overlay tree structures 
for the 44K and 88K versions of Linkage 
Editor F. 



|Name 

i mi _, . 


T T" ~ - T — "T~ ™ T 

| Description | Object |CSECT | Overlay | Chart 

j | Module Name | Name j Segment j ID 

| | (Microfiche | | ** j 

I I Name) | j j 
j _.. i iii 


T - - ' '" ■ 

| Synopsis 

i ... __. ... 


i 


r 

|Alias 

| Table 
i 


t 

| Table 

i .„. 




| IEWLMENT 
i 


| IEWLMENT | 

., j i.,.,, 


7,3 


T 

_l m .,„. 


t 

| ALIAS symbols from CESD 

,. i ,. .,. ,„..,,. 


1 

H 


r 

|A11 Purpos 

1 Table 


T 

e| Table 




T 

| IEWLMAPT 


1 1 

j IEWLMAPT j 

-4- 4- 


U1 


T 
4. 


T — 

| Major communication area 

. . i ,., .,.,_ ... 


| Calls 
| List 

|CESD 

L 


T 

| Table 

-+ 

| Table 

i 





T 

| IEWLMRAT 

| IEWLMESD 
A. 


T T 

j IEWLMRAT j 

| IEWLMESD | 
+ + 


3,2 
5,2 


T 
J. 


T 1 

| Entries for V-type ADCONS) 

(ESD control information | 
J J 


r 

| Delink 

| Table 

|_ 

| Downward 
| Calls 
| List 

i ,. ., 


1 

| Table 

-+ 

| Table 

, 1 _.„ 





| IEWLMINP 
| IEWLMENS 
j. 


| IEWLMINP | 
1 1 


3,2 


T 
4. 


\ 1 
| Entries for symbols being | 
j deleted | 


| IEWLMENS | 
+ + 


7,3 


T 

..J 


j Downward calls from 
| V-type ADCONS 

- 4. 


1 

H 
H 
H 

H 

H 

1 


1 

| Entry 
j List 


1 

| Table 

4. 




| IEWLMREL 

_L 


| IEWLMREL | 


8,3 


1 
i 


T 

| Control information for 
1 V-type ADCONS 

™ .j..-.-_ „., , - T .™ 


|FSNX 

| GETIDMUL 

L 


T 

(Entry 
j. 


Point |IEWLMFNL 

_. .1 


(IEWLMFNL| 
i i 


9,3 


T 
4. 


T 

(Synchronous file error 
j exit 


T 

| Lookahead/ 
j Readahead 
| Routine 


T 

| IEWLMSCD 

_i „ _ 


1 - ■ ! 
j IEWLMSCD j 

-4- 4- 


8,3 


T 

|MC 


(Get next ID/multiplicity 

__i 


|HESD 


| Table 
j. 




| IEWLMOUT 
i 


T T 
j IEWLMOUT j 
4. 4- 


7,3 


4- 


t " ""■ - " ~ ■ 

(ESD control information 

i 


|High ID 
j Table 

|IEWLCAD1 
| lEWLCAUT 

L - 


T 

(Table 
4. 




| IEWLMOUT 


T T 

j IEWLMOUT j 

_.. i i. 


7,3 


T 

, , j 


r 

(High ID for each segment 

1 ... . ... ,. _, 


T 

| Entry 

j Entry 

J. 


Point | IEWLMADA 
Point |IEWLMINC 


T T 

j IEWLMADA j 

j IEWLMINC j 


7,3 
3,2 


t 

|JS,JT 

L .. 


■"- 1 

(Compute number of ENTAB 
| bytes per segment 

(Automatic library call 
j processing 

-j. _ ~ ,-.. ..._, 


1 

_j 



(Continued) 
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(Continued) 



t r 

Overlay 

Segment 

** 



— i 



IEWLCDCN 



,. 

IEWLCDLK 






h 



IEWLCR01 

I" 

IEWLCSDB 

I 

IEWLEEON 

h 



Name 






IEWLCEOD 



IEWLCFAB 



IEWLCPTH 



+ _ 



IEWLCRBB 



IEWLCRBN 



Description 



Entry Point 



Entry Point 
JK 



Entry Point 



Entry Point 



Entry Point 



Entry Point 



Entry Point 



Entry Point 
Label 
Entry Point 



Object |CSECT 
Module Name | Name 
(Microfichej 

Name) 



IEWLMRCG 



IEWLMINP 



IEWLMINP 



IEWLMFNL 



IEWLMRCG 






IEWLMAPT 



IEWLMAPT 



IEWLMROU 






IEWLMROU 
IEWLMINP 






IEWLMRCG 



IEWLMINP 



IEWLMINP 



IEWLMFNL 



IEWLMRCG 



IEWLMAPT 



IEWLMAPT 
IEWLMROU 



+- 



IEWLMROU 
IEWLMINP 



— + +- 



5,2 
3,2 



| Remove CESD item from 
library chain 



3,2 



9,3 



5,2 



1,1 



1,1 
1,1 
1,1 



3,2 



Chart 
ID 



*JG 



*JF,JG, 



Synopsis 



-H 



Builds delink table 



EOD for SYSLIB 



Termination processing 



—\ 



Determine common segment 
in Overlay path 



Define SYSLIB DECB 



Define SYSLIN DECB 



SYNAD routine 



SYSLIN DCB 



-H 



EOD for SYSLIN 



-H 



IEWLERDM 



H 



Entry Point 



IEWLMINP 



IEWLMINP 



3,2 



Read Routine 



IEWLMADA 



CSECT 



IEWLMADA 



IEWLMADA 






7,3 



KA 






Address assignment 



IEWLMAPT 



CSECT 



IEWLMAPT 



IEWLMAPT 



1,1 






All purpose table 



IEWLMBTP 



CSECT 



IEWLMBTP 



IEWLMBTP 



h 



9,3 



*NA 



Print Error Messages 



IEWLMDEF 



CSECT 



IEWLMDEF 






IEWLMDEF 



1,1 



Default values for SIZE 



IEWLMEND 



CSECT 






IEWLMEND 



IEWLMEND 



5,2 



JN 






IEWLMENS 



CSECT 



IEWLMENT 



•CSECT 



IEWLMENS 
IEWLMENT 



IEWLMENS 
IEWLMENT 



7,3 
7,3 



KB 



KC,KD 



END Statement Processing 

.| 

ENTAB size determination 

H 



ENTRY statement process- 
ing 



IEWLMESD 

y 

IEWLMFNL 



CSECT 
CSECT 



IEWLMESD 



IEWLMESD 



5,2 






IEWLMFNL 



IEWLMFNL 



IEWLMINC 



CSECT 



+ + 



IEWLMINC 



IEWLMINC 



9,3 
3,2 



JE r JF r JG 

NA 



E3D record processing 



-H 



CSECT 



IEWLMINP 



IEWLMINP 



IEWLMINP 
j. 

IEWLMLDB 

F 



+ _ 



Label 



IEWLMROU 



-+. 



3,2 



Final processing 
JR | Include processing 

-! 



JA 



Input processing 



IEWLMLOG 



IEWLMROU 



IEWLMROU 

+ 

IEWLMROU 



1,1 



SYSLIB DCB 



Error Diag. 
and Log 
Routine 

CSECT 



1,1 



NC 



__ H 



Print error messages and 
log control cards 



IEWLMMAP 

Y 

IEWLMMDI 



IEWLMMAP 
Entry Point | IEWLMINP 



IEWLMMAP 



6,3 



LB 



MAP/XREF processing 






IEWLMINP 



3,2 



JB 



Object module processing 

__J 

(Continued) 
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(Continued) 



I- 

IEWLMOPT 



h~ 



IEWLMOUT | CSECT 
IEWLMRAT I CSECT 









h 



IEWLMSCD 
IEWLMSCN 

| 

IEWLMSYM 
| 

IEWLMTXT 



Name 






IEWLMRCG 



IEWLMREL 



IEWLMROU 












+ 



INP270 



RDRLD 



RDTXT 

| 

Relocation 
Constant 
Table 



Renumbering 
Table 



4 



RLD I/O 
Control 
Table 

RLD Note 

List 
| 

RLD001 



h 



Description 



CSECT 






CSECT 



CSECT 



CSECT 



CSECT 
CSECT 



CSECT 
CSECT 



IEWLMROU 

IEWLMSCD 

IEWLMSCN 

IEWLMSYM 
IEWLMRAT 



Label 

RLD Read 
Routine 



Text Read 
Routine 

Table 



Table 



Table 



Table 



IEWLMOPT 



IEWLMOUT 



IEWLMRAT 



IEWLMRCG 



IEWLMREL 



IEWLMINP 
IEWLMSCD 



+ 

IEWLMSCD 

+ 

IEWLMSCN 

+ 

IEWLMSYM 

IEWLMTXT 



+ 



IEWLMSCD 
IEWLMADA 



+ 



IEWLMESD 



IEWLMRAT 



IEWLMRAT 



CSECT 
Name 



IEWLMOPT 



IEWLMOUT 



IEWLMRAT 



IEWLMRCG 



IEWLMREL 



IEWLMROU 



+ + 









IEWLMINP 



IEWLMSCD 



+ 

IEWLMSCD 



IEWLMADA 



+ 

IEWLMESD 



IEWLMRAT 



+ + 



IEWLMRAT 



-+ 



Overlay 

Segment 

** 



2,2 



7,3 



LA 



Intermediate output 
processing 



3,2 






5,2 



8,3 



1r1 



*,3 

4,2 



5,2 
3,2 



3,2 
8,3 



8,3 



7,3 



+ 

3,2 



+ 

3,2 



3,2 



Chart 
ID 



JH 



MF,MG,MH 



MA, MB 
JO,JP 



f" 



JD 
JI 






JC 

MD 



MD 



Synopsis 



Object 
Module Name 
(Microfiche 

Name) 

*IA 



Determine attributes and 
options 



-H 



TXT and RLD processing 



H 



Replace/change processing 

.) 



Relocate address 
constants 



H 



Linkage editor F entry 
point 



Second pass processing 



Control statement scan- 
ning 



-H 



SYM processing 
TXT processing 



Load module processing 
Read RLDs from SYSUT1 



-H 






Read TXT from SYSUT1 



Relocation constants 



-1 



ESD - CESD item resolu- 
tion 



Description of RLDs on 
SYSUT1 



Location of RLDs on 
SYSUT1 



-H 



-H 



RLD 
Processing 
Routine 



IEWLMRAT 



IEWLMRAT 



3,2 



JK,JL 



RLD processing 



Table 



IEWLMOUT 



IEWLMOUT 



Scatter 

Table 



SCDENTAB 



ENTAB and 
ENTAL RLD 
Creation 
Routine 



IEWLMREL 



IEWLMREL 






7,3 

6,3 



Ordered symbol addresses 



*ME 






3uild and write ENTABs 
and ENTAL RLD to SYSLMOD 



(Continued) 
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(Continued) 



Segment lengths 



y + + + + + 4 1 

Segment j Table | IEWLMADA | IEWLMADA j 7,3 
Length 
Table 



h 



F 

SYSLMOD 
SYS PRINT 
SYSUT1 



h 



Name 






— T" 



SEGTAB 



SPLTADCN 



Test I/O 
Control 
Table (TTR 
List) 



TEXT Note 
List 



h 



Translation 
Table 



TXTSUF 



h 



WRTCRRLD 



WRTTXT 
RLDBUF 



Description 



Table 



Split ADCON 
Routine 



Label | IEWLMROU 
Label | IEWLMROU 
Label | IEWLMROU 



Table 



Table 



Table 



+ 



Table 



TXT Write 
Routine 



RLD/Control 

Record 
Write 

Routine 



Object 
Module Name 
(Microfiche 

Name) 



IEWLMOUT 



IEWLMREL 



IEWLMRAT 



f- 



IEWLMRAT 



Text I/O 
Table 

IEWLMRAT 



IEWLMOUT 



IEWLMRAT 



IEWLMSCD 



IEWLMSCD 



RLD Write | IEWLMRAT I IEWLMRAT 
Routine 



CSECT 
Name 



IEWLMOUT 



IEWLMREL 



IEWLMROU 



_ + + _ 



IEWLMROU 



IEWLMROU 
+ 

IEWLMTXT 



IEWLMTXT 



IEWLMTXT 



IEWLMOUT 



IEWLMTXT 



IEWLMSCD 



IEWLMSCD 



Overlay 

Segment 

** 



7,3 



6,3 



1,1 



1,1 



1,1 



+- 



3,2 



3,2 
3 r 2 



7,3 



3,2 



6 r 3 



6,3 



ME 



Write TXT to SYSLMOD 



TXT Write 
Routine 



3,2 



Chart 
ID 



*MF 






JJ 



*MA r MB 



-+ 



JM 



Synopsis 



Segment relationships 



Relocate split ADCONs 



-I 



SYSLMOD DCB 



SYSPRINT DCB 



SYSUT1 DCB 



Address of first text in 
each segment 



Description of TXT on 
SYSUT1 



-H 



-H 



Location of TXT on SYSUT1 



Pointers to Scatter Table 
entries 



Write test to SYSUT1 



^ 






Write RLDs and control - 
records 



-H 



Write RLDs and RLD Note 
List to SYSUT1 



♦Mentioned only; not a complete chart for this routine. 

**The first number refers to the segment in the 44K overlay structure; the second 
number refers to the segment in the 88K overlay structure. 
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Table 9. Level F Module — CSECT Cross 
Reference Table 



j Module Name 



CSECT Name 



IEWLMADA 
IEWLMAPT 
IEWLMBTP 

IEWLMEND 
IEWLMENS 
IEWLMENT 

IEWLMESD 
IEWLMFNL 
IEWLMINC 

IEWLMINP 
IEWLMMAP 
IEWLMOUT 

IEWLMRAT 
IEWLMRCG 
IEWLMREL 

IEWLMROU 
IEWLMSCD 
IEWLMSCN 

IEWLMSYM 



IEWLMADA 
IEWLMAPT 
IEWLMBTP 

IEWLMEND 
IEWLMENS 
IEWLMENT 

IEWLMESD 
IEWLMFNL 
IEWLMINC 

IEWLMINP 
IEWLMMAP 
IEWLMOUT 

IEWLMRAT , IEWLMTXT 

IEWLMRCG 

IEWLMREL 

IEWLMROU 
IEWLMSCD 
IEWLMSCN 

IEWLMSYM , IEWLMDEF 
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Overlay Tree Structure for the 44K Version of Linkage Editor F 



IEWLMINT 
IEWLMOPT 



IEWLMROU (Entry Point) 

IEWLMAPT 

IEWLMDEF 



IEWLMINP 
IEWLMRAT 
IEWLMTXT 
IEWLMINC 



IEWLMSCN 



IEWLMESD 
IEWLMEND 
IEWLMRCG 
IEWLMSYM 



IEWLMADA 
IEWLMENT 
IEWLMENS 
IEWLMOUT 



IEWLMMAP 



IEWLMREL 
IEWLMSCD 



IEWLMFNL 
IEWLMBTP 



Table and Buffer Area 



Data Management and Control Program Blocks 



Figure 35. Overlay Tree Structure for Linkage Editor F (44K) 
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IEWLMINT 
IEWLMOPT 
IEWLMINP 
IEWLMRAT 
IEWLMEND 
IEWLMESD 
IEWLMRCG 
IEWLMSYM 
IEWLMINC 
IEWLMSCN 
IEWLMTXT 



IEWLMROU (Entry Point) 

IEWLMAPT 

IEWLMDEF 



Table and Buffer Area 



IEWLMADA 

IEWLMOUT 

IEWLMENT 

IEWLMENS 

IEWLMFNL 

IEWLMBTP 

IEWLMMAP 

IEWLMSCD 

IEWLMREL 



Data Management and Control Program Blocks 



Figure 36. Overlay Tree Structure for Linkage Editor F (88K) 
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SECTION 5: TABLE LAYOUTS 



This section provides detailed layouts of internal tables used during Linkage Editor F 
processing. Table 10 indicates the modules in which tables are initialized and used or 
modified. Tables described in this section are included alphabetically except for the 
All Purpose Table r which is shown first. 



Table 10. Table Construction and Usage 
r 



T T 

Built by | Used and/or Modified by 



Table 



-H 



Alias Table 



IEWLMENT 



IEWLMFNL 



All Purpose Table 

i 



+ 

IEWLMINT 



** 



1 

IEWLMENS 

IEWLMRAT, IEWLMSCN, IEWLMINC, IEWLMAUT, 
IEWLMENS , IEWLMENT , IEWLMOUT , IEWLMTXT 



Calls List 
CESD 



LEWLMRAT 

+ 

IEWLMESD 



-H 



Delink Table 



IEWLMESD 



IEWLMRAT , IEWLMSCD 



-H 



Downward Calls List 



IEWLMENS 



Entry List 



Entry Table 



IEWLMSCD 

-I 

IEWLMSCD 



+ 



-H 



Half ESD 

Half ESD Prefix 



IEWLMOUT 

+ 

IEWLMSCD 



IEWLMSCD 



High ID Table 



IEWLMOUT 



Main Storage Allocation Table 
Relocation Constant Table 
y 

Renumbering Table 

RLD Input Control Blocks 
I— 



+- 



IEWLMINT 
IEWLMADA 

IEWLMESD 

IEWLMSCD 



IEWLMOUT , IEWLMSCD 
IEWLMRAT , IEWLMTXT 



-H 



RLD Note List 



IEWLMRAT 



IEWLMOUT , IEWLMSCD 



h 



RLD Output Control Blocks 



IEWLMSCD 



Second Pass Text Control Blocks 



IEWLMSCD 



SEGLGTH Table 



+ 

IEWLMADA 



-H 



Segment Table (SEGTA1) 



IEWLMOUT 



IEWLMSCD 



Text I/O Table 
| 

Text Note List 



IEWLMTXT 



IEWLMOUT, IEWLMSCD 









IEWLMTXT 



IEWLMOUT , IEWLMSCD 






IEWLMSCD 



IEWLMSCD 



TTR List (TXT I/O Control Table) 
|. ± ± 

♦Built and processed entirely within one routine. 

**Major communications area throughout linkage editor processing. 



j 
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Table 11. All Purpose Table (APT) 

All Purpose Table (APT) 






PDSE1 


8 


PDSE2 


PDSE3 


PDSE4 


16 


PDSE5 


PDSE6 


PDSE7 | PDSE8 


PDSE9 


24 


PDSE9 


PDSE10 


PDSE11 


PDSE12 


32 


PDSE12 


PDSE13 


PDSE14 | PDSE15 JPDSE16 


40 


PDSE16 


PDSE17 


PDSE18 


48 


PDSE18 


REGSA 


56 


REGSA 


64 


REGSA 


72 


REGSA 


80 


REGSA 


88 


REGSA 


96 


REGSA 


104 


REGSA 


112 


REGSA 


120 


REGSA 


| IOCT 


128 


IOCT 


136 


IOCT 


144 


IOCT 


APT0 | APT1 


APT2 | APT3 


152 


CTTR 


CSNO 


CRNO 


160 


PRAL 


FLCD 


168 


RCCE 


RCCB 


176 


ALCB 


OVCMBGAD 


184 


SGT1 


CLLT 


192 


TNT1 


RNT1 


200 


RLDINPAD 


RECNT 


208 


TXTIO 


ALAS 


216 


DLKT 


CHESD 


224 


SELST 


TNLS2 


232 


RNLS2 


TTRLIST 


240 


RLDOUTBF 


HIARADD 



a; u 

So 

t/> — 

jB eg 

.52 o 
O) a> 
« J? 



O £-§ 



248 


BITMAP 


256 


LINECNT 


1 HISEV 


INCBRKPT 


264 


CRRTINCL 


ENCDX 


ENT1X 


272 


ENR1X 


ENT2X 


ENR2X 


ENT0X 


280 


ENCLX 


ENDTX 


ENS1X 


BUFSIZ 


288 


HESD 


ENELTX 


ENRLD2X 


296 


ENSPX 1 


LSTS 


304 


EPSM 


312 


ENT1C 


ENR1C 


ENITC 


EN IRC 


320 


ENTOC 


ENCLC 


ENS1C 


ENASC 


328 


ENDTC 


ENCDC 


ENELTC 


ENT2C 


336 


ENR2C 


ENSPC 


SYSRTN 


344 


SYSRTN 


Spaces 


352 


Spaces 


360 


Spaces 


368 


Spaces 


376 


Spaces 


384 


Spaces 


392 


Spaces 


400 


Spaces 


408 


Spaces 


416 


Spaces 


ERDIG 


424 


SSI 


FFCADR 


432 


LIBNAME 


440 


LIBOPEN 


448 


L SAVATS |APTSWS|NEWSW|NEWSW: 


456 


MAXBF 


1 | IEWLCRBB 


464 


IEWLCRBB 


472 


IEWLCRBB 


480 


IEWLCRBB 



*■ o 

33. 



u^3 



488 


IEWLCRBN 


496 




IEWLCRBN 


• 


504 


IEWLCRBN 


512 


IEWLCRBN 


1 


IEWLCWBB 


520 


IEWLCWBB 


528 


IEWLCWBB 


536 


IEWLCWBB 


544 


RLDOUT1 


RLDOUT2 


552 


TXTBFBEG 


TXTBFEND 


560 


MULTSIZE 


UT1SIZE 


568 


SZSYSUT1 


RLDSIZE 


576 


VALUE1 


VALUE2 


584 


MSGONE 


MSGTWO 


592 


MSGTHREE 


IEWLCLAC 


600 


DECBLIN 


608 




DECBLIN 




616 


DECBLIN 


1 


DECBLIB 


624 


DECBLIB 


632 


DECBLIB 


640 


NEGATE 












-2 >- 



! u 

! "- 1 
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Explanation of APT Entries — Level F 



PDSE1 
PDSE2 

PDSE3 



PSDE4 
PDSE5 
PDSE6 
PDSE7 



PDSE8 



PDSE9 
PDSE 1 



Member or alias name of module being creat 

Relative disk address (TTR) of first record of module on SYSLMOD 

C-byte. Initial value 

Bit Alias indicator 

Bits 1-2 Number of TTRs in user's data 

Bits 3-7 Lengh of user's data in half words 
Relative disk address (TTRO) of first text record 

Relative disk address (TTR) of note list or scatter-translation record 
"L M byte: number of TTRs in note list if present 
First attribute byte. 



Module Attribute 



Initial Value 



Bit - Reenterable 

Bit 1 - Reusable 

Bit 2 - Overlay 

Bit 3 - Test 

Bit 4 - Only loadable 

Bit 5 - Block/scatter 

Bit 6 - Executable 1 

Bit 7-1 text record , no RLDs 

Second attribute byte 

Bit - Compatibility: on indicates 1 
not DC 

Bit 1 - Origin of first text record 1 
is zero 

Bit 2 - Entry point assigned by 1 
linkage editor is 

Bit 3 - Module contains no RLDs 1 

Bit 4 - Module can be reprocessed 
by linkage editor 

Bit 5 - Module does not contain 
symbol cards 

Bit 6 - Spare 

Bit 7 - Module is refreshable 

Total contiguous main storage requirements of this module 

Length of first text record 
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PDSE11 



Entry point address 



PDSE12 
PDSE13 
PDSE 14 
PDSE15 
PDSE 1 6 
PDSE 1 7 
PDSE 18 
REGSA 
IOCT 
APTO 



APT1 



APT2 



Assigned origin of first text record 

Length , in bytes, of scatter list 

Length r in bytes, of translation table 

ESDID of the first text record 

ESDID of the control section containing the entry point 

Entry point of main member name 

Member name of module 

Register save area for IOCS 

I/O control table 



All Purpose Indicators 
Bit - NCAL 



Initial Value 





Bit 1 - XREF 

Bit 2 - MAP 

Bit 3 - LET 

Bit 4 - LOG 

Bit 5 - XCAL 

Bit 6 - TXT/RLD 

Bit 7 - A library card has been read 
All purpose indicators 

Bit - More include input to come 
Bit 1 - Automatic library call in operation 

Bit 2 - Object or load module 

Bit 3 - Delete indicator 

Bit 4 - Entry point received 

Bit 5 - Symbolic or absolute entry point 1 

Bit 6 - Entry card received 

Bit 7 - ESD Write indicator 
All purpose indicators 

Bit - No length received 

Bit 1 - No length indication 

Bit 2 - First text record 

Bit 3 - Status indicator received 

Bit 4 - Include previously initiated 
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Bit 5 - I/O overlap bit 

Bit 6 - In module indicator 

Bit 7 - Programmer punched card continuation 

APT3 All purpose indicators 

Bit - End of file 

Bit 1 - Name card received; end of input 
for load module 

Bit 2 - End of SYSLIN input — (/*) 

Bit 3 - To STOW as replacement 

Bit 4 - First text of load module 

Bit 5 - First text of segment 

Bit 6 - RLDs for group 

Bit 7 - SYSLIB opened 

CTTR TTRO of first CESD record on SYSLMOD, if MAP or XREF is specified, 

CSNO Current segment number 

CRNO Current region number 

PRAL Pseudo register accumulative length 

FLCD Address of first deleted CESD entry 

RCCE Address of end of replace/ change chain 

ALCB Address of alias chain beginning 

OVCMBGAD Address of beginning of overlay chain 

SGT1 Address of SEGTA1 - 1 

CLLT Address of calls list table 

TNT1 Address of text note list 1 
. ROT1 Address of RLD note list 1 

RLDINPAD Address of RLD input buffer 

RECNT Address of relocation constant table and renumbering table - 1 

TXTIO Address of test I/O table 

ALAS Address of alias table 

DLKT Address of delink table - 1 

CHESD Address of composite ESD - 16 

SELST Address of second pass entry list 

TNLS2 Address of text note list 2 

RNLS2 Address of RLD note list 2 
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TTRLIST Address of TTR list 

RLDOUTBF Address of RLD output buffers 

HIARADD Address of hierarchy table 

BITMAP Switches denoting error messages logged 

LINECNT Lines on this page 

HISEV Highest severity message 

INC3RKPT Address of breaking point in include chain 

CRRTINCL Address of currently included ESD item 

ENCDX Maximum number of entries in CESD/HESD tables 

ENT1X Maximum number of entries in test note list 1 

ENR1X Maximum number of entries in RLD note list 1 

ENT2X Maximum number of entires in test note list 2 

ENR2X Maximum number of entries in RLD note list 2 

ENTOX Maximum number of bytes in text I/O table 

ENCLX Maximum number of entries in calls list 

ENDTX Maximum number of entries in delink table 

ENS1X Maximum number of segments 

BUFSIZ Size of load module input buffer 

HESD Address of HESD Table - 8 

ENELTX Maximum number of entries in second pass entry list 

ENRLD2X Maximum size on input RLD buffer 

ENSPX Used by IEWLMOUT 

LSTS Last segment in each region (regions 1-4) 

EPSM Entry point symbol or end card address/symbol 

ENT1C Current number of entries in text note list 1 

ENR1C Current number of entries in RLD note list 1 

ENITC Current number of bytes in text I/O control table 

ENIRC Current number of bytes in RLD I/O control table 

ENTOC Current number of bytes in text I/O table 

ENCLC Current number of bytes in calls list 

ENS1C Current number of entries in SEGTAB 

ENASC Current number of entries in alias table 

ENDTC Current number of entries in delink table 

ENCDC Current number of entries in HESD/CESD table 
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ENELTC 



Current number of entries in 2nd pass entry list 



ENT2C 

ENR2C 

ENSPC 

SYSRTN 

SPACES 

ERDIG 

SSI 

FFCADR 

LIBNAME 

LIBOPEN 

SAVATS 

APTSWS 



NEWSW 



NEWSW2 



Current number of entries in text note list 2 

Current number of entries in RLD note list 2 

Highest segment number with text 

Save area for registers 13 and 14 for return to scheduler 

Save area 

Address of IEWLMLOG 

System status indicator 

Highest address retained by allocator 

Name of library for automatic library call 

Name of library currently open 

Attributes save area 

Switches 



Initial Value 








Bits 0-3 space 

Bit 4 - Bit map processed 

Bit 5 - Linkage editor input received 

Bit 6 - SYM received 

Bit 7 - ESD received 

Switches for determining control 

Bit - If 0, first time in initial 

processing 

Bit 1 - If 1 f MAP/XREF entered from 1 

intermediate processor 
If 0, entered from final processor 

Bit 2 - If 0, all RLDs in core 

If 1, RLDs not in core 

Bit 3 - If r MAP/XREF not in control 
If 1, MAP/XREF is in control 

Bit H - If 0, normal printing on SYSPRINT 
If 1 , abort immediately r no printing 

Bit 5 - Hierarchy 

Bits 6 Spare 

Bit 7 - If one, purge TEXT /RLD buffer 

Switches for Second Pass Processing Initial Value 

Bit - More RLDs exist for current ID 

Bit 1 - Split RLD in output buffer 

Bit 2 - R and P pointers have been saved 
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Bit 3 - If 0, relative relocation factor 
needed 

If 1 r absolute relocation factor 
needed 

Bit 4 - Split RLD saved in HESD prefix 

Bit 5 - No RLDs exist for last text of 
segment or last text of module 

Bit 6 - RLDs are to be grouped with previous 
RLDs 

Bit 7 - R and P pointers for current chain 
are in buffer 

MAXBF Maximum blocking factor 

IEWLCRBB Control block for SYSLIB 

IEWLCRBN Control block for SYSLIN 

IEWLCWBB Control block for SYSPRINT 

RLD0UT1 Address of first RLD output buffer 

RLDINBF1 Address of first RLD input buffer 

RLDOUT2 Address of second RLD output buffer 

RLDINBF2 Address of second RLD input buffer 

TXTBFBEG Address of start of text buffer 

TXTBFEND Address of end of text buffer 

MULTSIZE Size of SYSLMOD multiplicity or record 

UT1SIZE Size of SYSUT1 record 

SZSYSUT1 SYSUT1 maximum bytes per track 

RLDSIZE Size of each RLD buffer: 1st pass output , 2nd pass input 

VALUE 1 Size (value 1) for available linkage editor storage 

VALUE2 Size (value2) for load module buffer 

MSGONE Indicates first message from IEWLMCPT 

MSGTWO Indicates second message from IEWLMOPT 

MSGTHREE Indicates third message from IEWLMOPT 

IEWLCLAC Address of current read block 

DECBLIN DECB for SYSLIN 

DECBLIB DECB for SYSLIB 

NEGATE End flag for all purpose table 

Note : The following areas are used by IEWLMSCD and IEWXMREL for other purposes: IOCT, 
SPACES, EPSM 



142 



Alias Table 

Built by: Entry Processor 

Referred to by: Final Processor 



CESD entry number - present only if symbol is one that is present in the CESD and is type 
SD or LR. This field contains zero for all other symbols (2 bytes). 



- Symbol - the eight-character alias name (8 bytes) 

Figure 37. Alias Table 

Calls List 

as built by RLD processor 



1 



3£ 



- 2 bytes of binary zeros 

1 Relocation pointer - points to the referred to symbol in the CESD (types SD, LR, ER and CM) (2 bytes). 

Relocation pointer (2 bytes) 
Relocation pointer (2 bytes) 
Position pointer - points to SD or PC in CESD that contains the references (V-constants) (2 bytes) 



Figure 38. Calls List (As built by RLD Processor) 



Calls List 

As altered and used by ENTAB size determination (IEWLCENS) 



8 


P 

1 


R 


R 


10 


P 
2 


R 


R 


R 


6 


ss 


P 
7 


R 


R 


R 


R 


8 


P 


R 


R 


Z 




























2 bytes of binary zeros 






























(End of chain indicator) 












Chai 


lina n, 


mlue 


- ins« 


jrted 


bv IEWLCENS — count, in bvte 


s. to 


next 


chain 
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alue ( 


?bvt 


rO 









Figure 39. Calls List (As altered and Used by ENTAB Size Determinations) 
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Composite External Symbol Dictionary (CESD) - Internal Format 

Built by: ESD Processor and Control Statement Processors 
Modified by: Address Assignment Processor 



X 



0-7 



8 9-11 121314,15 



- Chain pointer/chain ID/length - Chain pointer when the entry 
type is: ER-lnclude w/pointer or an ER-ddname 
that was extracted from a LIBRARY control statement 

Chain ID when the entry type is: 

ER-Library (the symbol was extracted from a LIBRARY control statement). 

Length of control section for type: 
SD, PC, PR, or CM (2 bytes) 

I — Subtype - ER 

ER-Control change 
ER-Control replace 
ER-Control delete 
ER-Control include w/pointer 
ER-Control include w/o pointer 
ER-ddname 
ER-Alias 
ER-Overlay 

ER-Unmatched library member 
ER-Matched library member 
ER-Unmatched no call 
ER-Matched no call 
ER-Never call 
ER-Delete 
ER-Replace 
(1 byte) 

- Segment number - this symbol appears in (1 byte). When type is 

PR, this byte contains the alignment value (See Half ESD). 



-Chain address/reverse chain ID - used to create a chain of CESD entries (3 bytes). 







Hex 


0000 


0000 


00 


mi 


0000 


F0 


1110 


0000 


E0 


1110 


1000 


E8 


1101 


0000 


DO 


1100 


0000 


CO 


1011 


0000 


B0 


1010 


0000 


A0 


1001 


0000 


90 


0000 


0010 


02 


0000 


0011 


03 


0000 


0100 


04 


0000 


0101 


05 


0000 


0110 


06 


0000 


1000 


08 


0000 


0000 


00 



-Type - Section definition (SD) xxxx 0000 

Label reference (LR) xxxx 001 1 

Private code (PC) xxxx 0100 

Common (CM) xxxx 0101 

Pseudo register (PR) xxxx 0110 

Null 0000 0111 

External reference (ER) xxxx 0010 
(1 byte) 



Subclassification - 
Delete xxxl xxxx 
Rep I ac e xxx 1 xxxx 
Insert xxlx xxxx 
Chain xlxx xxxx 
Map Ixxx xxxx 



NOTE: = Not applicable 
Symbol - the eight-character symbolic name (8 bytes) 

Figure 40. Composite External Symbol Dictionary (CESD) — Internal Format 
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Table 12. Normal Combination of Internal CESD Types 



CESD Entry Type 


Type Field 
(byte 8) 


Chain Address/ 
Chain ID 
(bytes 9-11) 


Segment 
Number 
(byte 12) 


ER Subtype 
(byte 13) 


ddname Pointer/ 
Chain ID/Length 
(bytes 14-15) 


Section Definition 


xxxx xOOO 




1 to 64 


Length of control section 


Private Code 


xxxx xlOO 




1 to 64 


Length of control section 


Common 


xxxx xlOl 




1 to 64 


Length of common area 


Pseudo Register 


xxxx xl 10 




Alignment 
value (1) 


Length of pseudo register 


External Reference 


xxxx 0010 


Hex 00 or 80 




0000 0000 




Label Reference 


xxxx xOl 1 




1 to 64 




CESD entry no. of 
SD or FC (ID) 


NULL 


0000 01 1 1 










Replace 


XXX 1 xxxx 






0000 0000 




Insert 


xx Ix xxxx 










Chain 


xlxx xxxx 










Map 


lxxx xxxx 










Delete 


XXX 1 xxxx 






0000 1000 




ER - Unmatched Lib- 
rary Member Name 


0000 001 


Reverse chain ID 




0000 0010 


CESD entry no. of 
next item (ID) 


ER - Matched Library 
Member Name 


0000 0010 


Reverse chain ID (2) 




0000 001 1 


CESD entry no. of 
next item (ID) 


ER - Unmatched No 
Call Name 


0000 0010 






0000 0100 




ER - Matched No Call 


0000 0010 






0000 0101 




ER - Never Call 


0000 0010 






0000 0110 




ER - Overlay Control 
Statement 


0000 0010 


Address of next 
item in the chain 




1001 0000 




ERE - Alias Control 
Statement 


0000 0010 


Address of next 
item in the chain 




1010 0000 




ERE - ddname from 

Library or Include Statement 


0000 0010 






1011 0000 


Forward chain 
PTR (Library only) 


ER - Include Control 
Statement w/o Pointer 


0000 0010 


Address of next 
item in the chain 




1100 0000 




ER - Include Control 
Statement with Pointer 


0000 001 


Address of next 
item in the chain 




1101 0000 


Pointer to li- 
brary's ddname 


ER - Replace Control 
Statement (3) 


0000 0010 


Address of next 
item in the chain 




1100 0000 




ER - Control Delete (4) 


0000 0010 


Address of next 
item in the chain 




1110 1000 




ER - Change Control 
Statement (3) 


0000 0010 


Address of next 
item in the chain 




1 1 1 1 0000 





1 . Alignment Value - Specifies boundary alignment 

of the pseudo register. 

00 = byte alignment 

01 = halfword alignment 
03 = full-word alignment 
07 = double-word alignment 

2. BLDL has been issued for this member name if bit 64 is set to 1 . 

3. Two CESD entries are made for each Replace or Change control statement, 
one entry for each symbol. 

4. This entry results from a Replace or Change control statement containing 
only a single symbolic name. 
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Delink Table 

Built by: RLD Processor (Delink Routine), 

Referred to by: Second Pass Processor, RLD Processor 



X 



Address - assigned to the symbol being deleted (3 bytes) 

CESD entry number (ID) - is the relocation pointer of an RLD item referring to the symbol that is 

replacing the identically named symbol (or symbols) to be deleted. (2 bytes) 



Figure 41. Delink Table 

Downward Calls List 

Built by and referred to by IEWLCENS routine 



X 



Segment number - entries are one for one with those of the CESD. If a 

downward call is made to a symbol, the segment's number from 
which the call is made is entered in the downward calls list 
at an entry corresponding to the ESDID of the symbol in the 
CESD. The list is initially zero. (1 byte) 

Figure 42. Downward Calls List 



Entry List 

Built by and referred to by Second Pass Processor 



X 



k — one — ►! 
• entry ' 



entry 



(6 bytes) 



- Address - linkage editor assigned address of the 
ENTAB entry for this symbol (3 bytes) 

1 Segment number - that will contain this ENTAB entry (1 byte) 

Half ESP entry number - corresponding to the CESD entry that 

contained the referred to symbol (2 bytes) 



Figure 43. Entry List 
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Entry Table (ENTAB) 

Built by Second Pass Processor 



Unconditional branch to last 
entry BC 15, DISP (15,0) 


Address of referred 
to symbol 


"to" seg 
number 


Previous Caller 
(zero initially) 


Unconditional bianch to last 
entry BC 15, DISP (15,0) 


Address of referred 
to symbol 


"to" seg 
number 


Previous Caller 
(zero initially) 


1 
1 





















Unconditional bianch to last 
entry-BC 15, DISP (15,0) 


Address of referred 
to symbol 


"to" seg 
number 


Previous Caller 
(zero initially) 


SVC 45 


L 15, 4 (0,15) Loads GR15 with 
the value of the ADCON 


BCR 15,15 


"from" 
seg no 


Address of segment 
table (SEGTAB) 



■ 2 bytes ■ 



-2 bytes - 



-2 bytes - 



-2 bytes - 



-1 byte- 



-3 bytes - 



DISP — is the displacement, in bytes, of this entry from the last entry. 

"to" segment number — is the number of the segment containing the symbol being referred to. 

"from" segment number — is the number of the segment that contains this entry table. 

Figure 44. Entry Table (ENTAB) 



Section 5: Table Layouts 147 



Half External Symbol Dictionary 

Built by: Intermediate Output Processor 

Referred to by: Second Pass Processor 



X 



JL 



one 

entry (8 byte's) 



Length (3 bytes) 

— Segment Number* - segment in which this symbol appears. Segment number = 
1 in non-overlay programs. (1 byte) 

— Linkage Editor assigned address - of this symbol (absolute value of the address constant) (3 bytes) 

Indicator-Type - Bit zero is not used. Bits 1, 2 and 3 are used as an indicator field that applies to: 
SD,PC - Bit 1 = — this control section (SD or PC) does not have 

the highest CESD entry number with text in this segment 
= 1 — this control section (SD or PC) has the 

highest CESD entry number in this segment 
SD,PC or CM - Bit 2 = — relative relocation constant is a positive value 
= 1 — relative relocation constant is in 
complemented form 
PC delete - Bit 3 = 1 — indicates that this unnamed control section 

is a SEGTABor ENTAB. 

Bits 4, 5, 6 and 7 are used to specify the entry type : 
0000 = Section Definition (SD) 

0010 = External Reference (ER) - all fields are zero except type 

0011 = Label Reference (LR) 

01 00 = Private Code (PC) 

0101 = Common (CM) 

* 01 10 = Pseudo Register (PR) - the segment number field contains a byte alignment value as follows: 

= byte alignment 

1 = half word alignment 
3 = full word alignment 

7 = double word alignment 
01 1 1 = Null - all fields are zero except type 

Figure 45. Half External Symbol Dictionary 



High ID Table 

Built and referred to by Intermediate Output Processor 



X 



' CESD entry numbei - entries are in segment number order. Each 

entry contains the highest CESD entry number 
(ID) assigned to a section definition (SD or PC) 
within that segment. (2 bytes) 

Note : If segment does not contain text, its corresponding entry contains zero. 

Figure 46. High ID Table 
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Level F Main Storage Allocation Table 
Used by Allocation Processor 



Minimum Size - The minimum number of bytes 
of main storage required for 
this table (2 bytes). 

■Weight - The factor used to allocate extra main storage 
to enlarge the table. It specifies how many 
bytes will be added to this table for every 582 
bytes (or 603 bytes, with overlay) which become 
available (2 bytes). 

Number of Bytes per Entry - The number of bytes per entry for 
this table (1 byte). 



Number of Entries - 156 - 



Address ■ 



A value to which must be added 156 to 
determine the address in the all purpose 
table at which the number of entries value 
for this table is to be stored (1 byte). 



156 - A value to which must be added 156 to determine the 

address in the all purpose table at which the determined 
address for this table is to be stored (1 byte). 



■ Indicators - ( 1 byte ) 
Bi 



Bi 



Bi 



t - Table needed to process overlay modules only 

t 1 - Table needed during first pass 

t 2 - Table needed for intermediate processing 

t 3 - Table needed during second pass 

t 4 - Table requires double - word alignment 

t 5 - Table requires word alignment 

t6 - NA 

t 7 - Table has a zeroeth entry (prefix) 



End Flag - FF (1 Byte) - 

Figure 47. Level F Main Storage Allocation Table 



Relative Relocation Constant Table 

Built by and referred to by Address Assignment Processor 



3i 



" Relocation Constant = (linkage editor assigned address)-(previously assigned address) of a 
control section (SD, PC or CM) or a label reference (LR). The 
entries are one for one with CESD, in true or complement form. Com- 
plement form specified by binary ones in the high-order byte (4 bytes) 

Figure 48. Relative Relocation Constant Table 
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Renumbering Table 

Built by: ESD Processor 

Referred to by: TXT, RLD, END and ESD Processor 



3£ 



0,1 2 3 



Type 



Subtype 



Bits 567 




Bits 01234 


Section Definition - 


000 


Null 


- 000000 


Label Reference 


Oil 


Delete 


- 00010 


External Reference - 


010 


Replace 


- 00010 


Private Code 


100 


Chain 


- 01000 


Common 


101 


Insert 


- 00100 


Pseudo Register 


110 


Library 


- 10000 


Null 


111 






(1 byte) 









Flag 



to indicate whether the section definition (SD or PC) this entry corre- 
sponds to is present in the CESD (0000 0001), or that other CESD items 
are dependent on its presence (0000 0010), or that a Delink Table entry 
was created for this symbol (0000 0100). (1 byte) 
CESD entry number (ID) - points to an entry in the CESD. (2 bytes) 



Figure 49. Renumbering Table 



RLD Input Control Block* 

Build and referred to by second pass RLD processor 



Address of RLD note list entry 
marking the end of the RLD 
grouping (4 bytes) 



— Address of current RLD note list entry 
being processed (4 bytes) 



- Address of RLD notelist entry marking the 
beginning of the RLD grouping (4 bytes) 



Beginning address of RLD input buffer (4 bytes) 
— Lowest RLD address of unprocessed RLDs in current RLD set (3 bytes) 



— Flags (1 byte) 

Bit - 1 Control block in use 

Bit 3 - Control block governs RLD input buffer 1 
1 Control block governs RLD input buffer 2 



* There is a control block for each of two input buffers. 

Figure 50. RLD Input Control Block 
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Level F RLD Note List 

Built and referred to by First Pass RLD Processor 











\ 














— Address - Displacement in words from 
beginning of record 












TTR If last entry of a group 










L Length - The number of words of RLD data (2 bytes) 








L - Lowest Multiplicity - of the control section referred to 
by the ID field, to which the RLD 
information in this record pertains 
(10 bits) 






Flags - Bit - 
1 


RLDs Not in Core 
RLDs in Core 




Bit 1 - Not Processed 
1 Processed 




Bit 2 - Entry is Grouped 

1 Entry Contains a TTR 




Bit 3 - RLDs in Buffer 1 
1 RLDs in Buffer 2 




Bit 4 - 

1 Split RLD in Set (Second Pass) 




Bit 5 - 

1 Currently Being Processed (Second Pass) 




— in 


_ TL~ 


ret 


:n — 


i.-, c~ 






.«.:««.. /en -*- Df\ I** 



which this RLD information pertains 

Figure 51. Level F RLD Note List 
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RLD Output Control Block * 

Built and referred to by Second Pass RLD Processor 



— Address of end of buffer - 
(4 bytes) 



Address of beginning of buffer (4 bytes) 



First free address in the buffer (4 bytes) 
— Length in bytes of ID-length list (2 bytes) 



Flags Byte 1 Bit - 1 Control block in use 

Bit 1 - 1 Buffer is being written 

Byte 2 Bit 8 - 15 Constant to turn off use bits in 

the text control block 
For: Buffer 1 - X 'DB' 
Buffer 2- X 'ED' 
Buffer 3- X 'F6' 



* There is a control block for each of three RLD output buffers. 

Figure 52. RLD Output Control Block 
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Second Pass Text Control Block* 

Built and referred to by Second Pass Text Processor 



■ CCW Displacement for text (4 bytes) 
Accumulated length of text (2 bytes) 

Length of current text (2 bytes) 

Address of text I/O table entry marking end of 
text grouping (4 bytes) 

Address of text I/O table entry marking beginning of text 
grouping (4 bytes) 

— Address of current text I/O table entry being processed (4 bytes) 

End address of text in buffer (4 bytes) 
■ Beginning address of text in buffer (4 bytes) 



*— Flags - Byte 1 

(4 bytes) 



Byte 2 



Bit - 

1 - 

2 - 

3 - 
4- 
5 - 
6- 
7- 

Bit - 

1 - 

2 - 
3- 
4- 
5 - 

6- 

7- 



Byte 3 



Control block in use 
Text being written 
Text being read 
Text has RLDs 
Text is first of group, 
Text is last of group 
Text is last in segment 
Text is last in load module 

XDAP write needed 

Dummy write needed 

RLD output buffer 1 is being used 

RLD output buffer 2 is being used 

RLD output buffer 3 is being used 

RLD output buffer 1 contains ID -length list for 

this text 

RLD output buffer 2 contains ID-length list for 

this text 

RLD output buffer 3 contains ID-length list for 

this text 



Bit - 1 RLD input buffer 1 contains RLDs for this text 

1 - 1 RLD input buffer 1 contains processed RLDs for 

this text 

2 - 1 RLD input buffer 2 contains RLDs for this text 

3 - 1 RLD input buffer 2 contains processed RLDs for 

this text 

4 - 1 There is more text to process after current text 



* There are two text control blocks — one for current text being processed, another 
for next text to be processed or text just processed. 

Figure 53. Second Pass Text Control Block 
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Segment Length Table 



Built and referred to by address assignment processor 
Appearance of table after assignment of control section addresses 



3 I 



Highest ID or ENTAB Entry Count for Segment (2 bytes) 



Flag (1 byte) - Bits through 3 not used 

Bit 4 = — next two bytes contains the highest ID of the segment 

= 1 ~ next two bytes contain the number of ENTAB entries for this segment 

Bits 5,6,7 - The low-order three bits of the previously assigned address of the first control section of 
this segment 

Cumulative Segment Length (3 bytes) - in bytes, of control sections in this segment (including the ENTAB, if present) 



Appearance of table after segment addresses are determined 

1 I 



Segment Relocation Constant (3 bytes) - for the segment that corresponds to this entry 



Path Length - (3 bytes) - in bytes, of this segment, including this segment and its ENTAB 



Figure 54. Segment Length Table 
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Segment Table (SEGTAB) 

Built by Intermediate Output Processor 



TEST 
Indicator 




Address of Data Control Block (DCB) used to load module * 




Address of note list * 


Last segment 
number of region 1 


Highest segment no. 
in storage -region 1 


Last segment 
number of region 2 


Highest segment no. 
in storage-region 2 


Last segment 
number of region 3 


Highest segment no. 
in storage -region 3 


Last segment 
number of region 4 


Highest segment no. 
in storage-region 4 


Zero 


(Not used in the Fixed-Task Supervisor) * 


(Not used in the Fixed-Task Supervisor) * 


Previous segment * 
number for segment 1 


Zero 


Status 
Indicator 


Previous segment 
number for segment 2 


Address of entry table entry (when caller 

chain exists) * 


Status 
Indicator 



Previous segment 
number for segment N 



Address of entry table entry (when caller 
chain exists) 



Status 
Indicator 



4 bytes 



TEST indicator — specifies that this module is "under test" using 

TESTRAN. (Bit 1) Initialized by program fetch. 
Highest segment no. in storage — is initially set to 00 except for 

region 1 which is initially set to 01 by linkage editor. 

Status indicator — indicates the status of this segment with the 

two last bits of the entry table address field as follows: 

00 — segment is in main storage as a result of a branch to the segment. 

10 — segment is in main storage, no caller chain exists. 

01 — segment is not in main storage, but is scheduled to be loaded. 

1 1 — segment is not in main storage. 

The status indicator for segment 1 is initially 
set to 10, all the rest are initially set to 1 1 . 



* set to zero by linkage editor 

Figure 55. Segment Table (SEGTAB) 
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Level F Text i/O Table 

Built and referred to by First Pass Text Processor 



Multiplicity Number of this piece of text (10 bits) 



Flags - Bit Text is not in core 
1 Text is in core 

Bit 1 Corresponding TXT note list entry 
is a grouped entry 
1 Corresponding TXT note list entry 
contains a TTR 

Bit 2 Text not out - of - order 
1 Out - of - order text 

Bit 3 Text has not been processed (2nd pass ) 
1 Text has been processed (2nd pass ) 

Bit 4 Corresponding TXT note list entry contains 
the true length of the text 
1 Corresponding TXT note list entry contains 
a full multiplicity length which is larger 
than the actual length of the text 



— ID-The CESD entry for this control section (SD or PC) (2 bytes) 

Figure 56. Level F Text I/O Table 



Level F Text Note List 

Built and referred to by First Pass Text Processor 



Length - The number of bytes of text (2 bytes) 

Address - Storage address if text is in core 
- TTR if non-grouped entry or last 
entry in a group (3 bytes) 



Displacement - Location of this text relative to the beginning 
of the multiplicity - used only for out-of-order 
text (2 bytes) 

Figure 57. Level F Text Note List 
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Partitioned Organization Directory Record 
As received from BLDL 



Byte 




4 


Name of Load Module (Member or Alias Name) 


8 


Relative (to beginning of data set) track address of module (TTR) 


Concatenation 
number 


12 


Byte of binary 
zeros . * 


Alias indicator and 
miscellaneous info 


Relative (to beginning of data set) 
track address of first text record 


16 


Continuation of 
track address 


Byte of binary 
Zeros 


Relative (to beginning of data set) 
track address of note list or scatter- 


20 


translation record 


Number of entries 
in note list ** 


Module attributes 

0, 1,2, 3,4,5, 6,7, 8, 9, 10, 11, 12, 13,R, 15 


24 


Total contiguous quantity of main storage required by the 
module 


Length (in bytes) of 
first text record 


28 


Continuation of 
length 


Module's linkage editor assigned entry point address 


32 


Linkage editor assigned origin of first text record 





For load modules in scatter format add: 



Length of Scatter 



36 



40 



List (in bytes) 



Length of translation table (in bytes) 



ESDID (CESD entry 
number of control 



section name) for 
first text record 



ESDID (CESD entry number of control 
section name) containing entry point 





For load modules with RENT or REUS attribute and alias names 


add j 


Entry point address 


44 


of the member name 






48 


Memt 


>er Name 


52 









SSI Bytes - Aligned on a halfword boundary at the end of the PDS record 



Alias indicator and miscellaneous information: 

1. Alias indicator — signifies none, 1 signifies alias — bit 

2. Number of relative disk addresses (TTR) in user data field — bits 1 ,2 

3. Length of user data field (in halfwords) — bits 3-7 

PODS Directory Record size: 

Block format 36 bytes (with alias names, 46 bytes) 

Scatter format 44 bytes (with alias names, 54 bytes) 

For SSI, add 4 bytes to sizes given above 

*This is normally a zero byte inserted to maintain halfword boundaries. 
If *he DCB operand was specified as zero and the name was found in the link library, this 
byte w- II contain a 1; if the name was found in the job library, this byte will contain a 2. 
**This byte contains zero if load mdule is not in overlay. 
R=Reserved 



Figure 58. Partitioned Organization Directory Record 
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Module Attributes 



Bit Number 


Attributes 





RENT 


1 


REUS 


2 


OVLY 


3 


TEST 


4 


LOAD 


5 


Format 


6 


Executable 


7 


Format 


8 


Compatibility 


9 


Format 


10 


Format 


11 


Format 


12 


Editability 


13 


Format 


14 


Reserved 


15 


REFR 



Bit Setting 


1 

1 

1 


1 


1 

1 


1 



1 



1 



1 



1 



1 



1 



1 



Indication 

Not re-enterable 

Re-enterable 

Not reusable 

Reusable 

Not an overlay module 

Overlay module 

Not under test 

Under test 

Not only loadable 

Only loadable * 

Block format 

Scatter Format 

Not executable 

Executable 

Module contains more than one text record and/or RLD record(s). 

Module contains only one text record and no RLD record. 

Module can be processed by all levels of linkage editor. 

Module cannot be reprocessed by linkage editor E. 

Linkage editor assigned origin of first text record is not zero. 

Linkage editor assigned origin of first text record is zero. 

Linkage editor assigned entry point is not zero. 

Linkage editor assigned entry point is zero. 

Module contains RLD record(s) 

Module does not contain an RLD record. 

Module can be reprocessed by linkage editor. 

Module cannot be reprocessed by linkage editor. 

Module does not contain TESTRAN symbol records. 

Module contains TESTRAN symbol records. 



Module is not refreshable 
Module is refreshable 



*Module can be loaded only with the LOAD macro-instruction. When the module 
is in main storage, it is entered directly, not through the use 
of a XCTL, LINK or ATTACH macro-instruction. 

Figure 59. Module Attributes 
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Partitioned Organization Directory Record 
As built by linkage editor 



Byte 
4 


Name of load module (Member or alias name) 


8 


Relative (to beginning of data set) track address of 
module. (TTR) 


Alias indicator and 
miscellaneous info. 


12 


Relative (to beginning of data set) track address of first 
text record. (TTR) 


Byte of binary 
zeros. 


16 


Relative (to beginning of data set) track address of note 
list or Scatter/translation record. (TTR) 


Number of entries 
in note list.* 


20 


Module Attributes (see below) 
0,1,2,3,4,5,6,7,8,9,10,1 1,12, 13, R, 15 


Total contiguous main storage required 


24 


for the module. 


Length (in bytes) of first text record. 


Module's linkage 


28 


editor assigned entry point address 


Linkage editor assigned origin of 


32 


first text record 








For load modules in scatter format add: 



36 



40 





Length of scatter list (in bytes) 


Length of trans la- 


tion table 

(in bytes) 


ESDID (CESD entry number of control 
section name) for first text record. 


ESDI D (CESD entry 
number of control 


section name) cont- 
aining entry point. 


For load modules with RENT or REUS attribute and Alias 



names add: 



Entry point address of the member name 



Member name 



SSI Bytes - Aligned on a half-word boundary at the end of the PDS 
record . 



Alias indicator and miscellaneous information : 

1. Alias indicator — signifies none, 1 signifies alias — bit 

2. Number of relative track addresses in user data field — bits 1 ,2 

3. Length of user data field (in halfwords) — bits 3-7 



PODS Directory Record size : 
Block format 34 bytes 

Block format with alias names 44 bytes 
Scatter format 42 bytes 

Scatter format with alias names 52 bytes 

For SSI, add 4 bytes to sizes given above 



R=Reserved 

*This byte contains zero if load module is not in overlay. 



(when rounded to a half-word boundary) 



Note: The I/O conventions and 
record formats for Linkage Editor (E) 
and Linkage Editor (F) are the same. 



Figure 60. Partitioned Organization Directory Record 
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TABLE - referred to by IEWLCBPT. 



X 



r 



Pointer - to beginning of a group of entries in LIST. (2 bytes) 

Figure 61. Table - Referred to by IEWLCBPT 

LIST - referred to by IEWLCBPT. 



3£ 



- End of Message Indicator - delimits a group of entries that define 
a message. (1 byte - hex FF) 



— Pointer ~ to the first character of a phrase. (2 bytes) 
Count-1 - of characters in the phrase. (1 byte) 

Figure 62. LIST - Referred to by IEWLCBPT 



XAD2CESD Table - built and referred to 
by Cross Reference Table Routine 



X 



1 — Composite ESP entry number - specifies the CESD entry containing the 
symbol (2 bytes) . 

Figure 63. XAD2CESD Table — Built and Referred to by Cross Reference Table Routine 
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SECTION 6: DIAGNOSTIC AIDS 



This section contains information that may be useful in diagnosing difficulties with 
the linkage editor program. Included are: register contents at entry to modules, charts 
describing buffer and table allocation, and an error message — module cross reference 
table. 

Table 13. General Register Contents at Entry to Module 

r T" 



Module 
Entry Point 



Register Contents 



IEWLMADA 



h 



2 — Address of all purpose table 



-H 



IEWLMBTP 



| 

IEWLMEND 



2 — Address of all purpose table 

14 — Return address 

15 — Entry point address 



2 — Address of all purpose table 

4 — Length of any no-length control section 

5 — ID of the assembled address of the module entry point 

13 — Address of save area 

14 — Return address 

15 — Entry point address 



-H 



IEWLMENS 



2 — Address of all purpose table 

13 — Save area address 

14 — Return address 



IEWLMENT 



h 



2 — Address of all purpose table 

13 — Save area address 

14 — Return address 



-H 



IEWLMESD 



h 



2 — Address of all purpose table 

4 — Byte count of ESD information 

5 — ID of first ESD item to be processed 

6 — Address of first ESD item to be processed 

13 — Save area address 

14 — Return address 

15 — Entry point address 



IEWLMFNL 



2 — Address of all purpose table 



-H 



IEWLMINC 



| 

IEWLMINP 



2 — Address of all purpose table 
15 — Entry point address 



2 — Address of all purpose table 
15 — Entry point address 



— I 



IEWLMINT 



IEWLMMAP 



1 — Pointer to parameter list 

13 — Save area address 

14 — Return address 



2 — Address of all purpose table 

14 — Return address if entry is from IEWLMOUNT 

15 — Address of entry point 



-H 



— I 



IEWLMOPT 



1 — Pointer to parameter list 

2 — Address of all purpose table 
15 — Entry point address 



j 



(Continued) 
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Table 13. General Register Contents at Entry to Module (Continued) 

r 



Module 
Entry Point 



Register Contents 



IEWLMOUNT 



h 



IEWLMRAT 



h 



2 — Address of all purpose table 



2 — Address of all purpose table 
4 — Byte count of RLD input 
6 — Storage address of RLD input 
14 — Return address 



^ 



IEWLMRCG 



h 



2 — Address of all purpose table 

6 — Address of ESD item being processed 

10 — Address of beginning of REPLACE/CHANGE chain 

13 — Entry point address 



— I 



IEWLMREL 



SCDENTAB 



1 — HESD address of either first ENTAB entry (if overlay) or last 

HESD entry + 8 

2 — Address of all purpose table 

3 — Address of text control block for current text 

12 « Address of IEWLMSCD 

13 — Address of APT register save area (REGSA) 

14 — Return address 

15 — Entry point address (IEWLMREL) 

2 — Address of all purpose table 

3 — Address of text control block for current text 

8 — Address of control block for previous control record 

12 — Address of IEWLMSCD 

13 — Address of APT register save area (REGSA) 

14 — Return address 

15 — Entry point address (IEWLMREL) 



-H 



IEWLMROU 



IEWLCRO 1 



IEWLCR02 



IEWLCRO 3 



IEWLEPNT 



1 — Pointer to parameter list 

14 — Return address 

15 — Entry point address (IEWLMROU) 

— DECB address 

1 — DCB address 

2 — Address of all purpose table 

14 — Return address 

15 — Entry point address (IEWLCR01 or IEWLCR02) 

1 — Address of IOB for XDAP 

2 — Address of all purpose table 

14 — Return address 

15 — Entry point address (IEWLCR03) 

2 — Address of all purpose table 

14 — Return address 

15 — Entry point address (IEWLEPNT) 



^ 



IEWLMLOG 



— Error Code 

1 — Address of first symbol (optional) 

2 — Address of all purpose table 

13 — Address of second symbol (optional) 

14 — Return address 



(Continued) 
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Table 13. General Register Contents at Entry to Module (Continued) 

r T 

Module 
Entry Point 

IEWLMSCD 



GETIDMUL 

RDTXT 

RDRLD 

GETIDMUL 

RDTXT 

RDRLD 

WRTCRRLD 

WRTCRRLD 



h 



Register Contents 



1 — Address of first HESD ENTAB entry (overlay) or first entry 

beyond HESD 

2 — Address of all purpose table 

— Indicator: - prime read; 1 - lookahead 

1 — Text control block address 

1 — Current TXTIOT entry address 

1 — Current RLD notelist entry address 

2 — Address of all purpose table 

3 — Address of control block for current text 

4 — Address of control block for previous or next text 

1 — Address of control block for buffer to be written 

12 — Address of IEWLMSCD 

13 — Address of APT register save area (REGSA) 

14 — Return address 

15 — Address of IEWLMREL 



IEWLMSCN 



1 — Address of column 1 of input record 

2 — Address of all purpose table 
15 — Entry point address 



— I 



IEWLMSYM 



IEWLMTXT 



2 — Address of all purpose table 

13 — Save area address 

14 — Return address 

15 — Entry point address 

2 — Address of all purpose table 

3 — Assembled address of first byte of text 

6 — TD of current text record 

7 — Base register of IEWLMTXT (entry register) 
12 — Base register of IEWLMRAT 

14 — Return address 
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Table 14. Buffer Allocation 

BUFFER ALLOCATION - (LINKAGE EDITOR F) 



Initial and Input Processing 



Intermediate Processing 



Second Pass Processing 



Object Module Buffer 1 
3200 bytes (max.) or 800 bytes or 400 bytes (min.) 



Object Module Buffer 2 
3200 bytes (max.) or 800 bytes or 400 bytes (min.) 



SYSLIN Buffer 1 
3200 bytes (max.) or 800 bytes or 400 bytes (min .) 



SYSLIN Buffer 2 
3200 bytes (max.) or 800 bytes or 400 bytes (min.) 



Print Buffer 1 
4840 bytes (max.) or 1216 bytes or 608 bytes (min. 



Print Buffer 2 
4840 bytes (max.) or 1216 bytes or 608 bytes (min.) 



RLD Buffer Area 
1024 bytes 



Text Buffer Area 
102400 bytes (max.) or 6144 bytes (min.) 



Initial and Input 
Processing Tables 



Intermediate 
Processing Tables 



Second Pass 
Processing Tables 
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Table 15. Table Allocation 



r - "■"' " ~i 


r i 


-i 


r 


"T- 


"■ 1 


r 




i 


r i 


r t 




1 


| Table Name 


OVLY 


Order 


Bytes/ | Weight | Present In 


Prefix 


Align 


Size (in 


bytes) 


1 




Only 


in 


Entry 






(. T r ^ 








T 


H 










Coding 








I Inp. 
| Proc. 


Int. 
Prcc. 


2nd 
Pass 






Win. 


(Max. 




I _ _ r . ,. .... ... 




. 




I 




L J 


, , , 




, , _-j 


. 


_.j , 


j 


1 1 


r 1 


f 


r 


I 




r 1 






r i 


r t 


T 


1 


| Alias Table 


No 


4 


1 







| No 


Yes 


Yes 


No 


Byte 


50 


j 50 




| Calls List 


Yes 


18 


1 




20 


| Yes 


Yes 


NO 


No 


Word 


1368 


I * 




| Composite ESD 


No 


10 


16 




352 


[Yes 


NO 


No 


Yes 


Dlbwd 


5600 


I # 




| Delink Table 


NO 


3 


5 




30 


|Yes 


Yes 


Yes 


Yes 


Byte 


500 


I * 




| Entry List 


Yes 


12 


6 




6 


No 


No 


Yes 


!No 


Byte 


600 


I * 




| Half ESD 


NO 


6 


8 




176 


| No 


Yes 


Yes 


NO 


Dblwd 


2800 


I * 




| Half ESD 


No 


5 


8 







| No 


Yes 


Yes 


NO 


Dblwd 


8 


I 8 




| Prefix 




























| First Pass 


NO 


9 


! 1 







| Yes 


No 


|No 


No 


Word 


256 


| 256 




j RLD Buffer 




























| Second Pass 


No 


11 


t 1 







| No 


No 


[Yes 


No 


Word 


768 


| 768 




| RLD Buffer 




























(Relocation 


NO 


17 


4 




88 


| No 


Yes 


Yes 


Yes 


Word 


1400 


I * 




| Constant 




























| Table 




























| Renumbering 


No 


16 


4 




88 


| Yes 


No 


|No 


Yes 


Word 


1400 


I * 




| Table 




























(Renumbering 


No 


16 


1 







|Yes 


Yes 


|Nc 


No 


Word 


4 


I ^ 




| Table 




























| Prefix 




























| RLD Note 


No 


15 


9 




28 


| Yes 


Yes 


|No 


No 


Byte 


450 


I * 




j List I 




























| RLD Note 


No 


8 

List i: 


9 

I 




112 


| No 


| Yes 


|Yes 


|No 


Byte 


1800 


I * 




|SEGTA1 


Yes 


2 


| 1 







|Yes 


Yes 


(Yes 


Yes 


Byte 


| 256 


| 256 




(Text I/O 


No 


1 


4 




48 


|Yes 


[Yes 


Yes 


|No 


algslil 






i .._ _ 


L J 


L 


L 


L 




L J 


L 


L 


L.., .- -1 


L 


_-L 


.j 


(♦Maximum is d< 


2ternu 


med by i 


rain storage a-< 


/ailab] 


Llity 












i 


|#CESD maximum 


= (2- 


» 6 -1) x : 


Z* 
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Table 16. Error Message — Module Cross Reference Table 



r ~ i 

J MMS 


r 

Module Where Error Occurred 

L ^ _ , ^ _ _ _, , ,. - - , - - - 


1 

i 

„_ _ j 


| 012 


IEWLMSCD 


1 


| 022 


| IEWLMSCD 




| 033 


IEWLMENT 




| 053 


I IEWLMENT 




| 063 


IEWLMENT 




| 073 


IEWLMENT 




| 083 


IEWLMENT 




| 093 


j IEWLMENT 




| 102 


LEWLMEND 




| 113 


IEWLMENT 




| 123 


IEWLMADA 




| 132 


| IEWLMADA 




| 143 


IEWLMOUT 




| 152 


IEWLMENS 




| 161 


IEWLMENS 




| 161 


IEWLMENS 




| 172 


IEWLMENS 




| 182 


IEWLMENS 




| 192 


IEWLMADA 




| 202 


IEWLMADA 




| 212 


IEWLMINP 




| 222 


IEWLMESD r IEWMINP, IEWLMRAT 




| 232 


IEWLMESD , IEWLMINP , IEWLMRAT 




| 241 


IEWLMESD 




| 254 


IEWLMESD r IEWLMADA 




| 264 


IEWLMESD 




| 274 


IEWLMINC 




| 284 


IEWLMSCN, IEWLMINT 




| 294 


IEWLMINT, IEWLMFNL 




| 302 


IEWLMSCN 




| 314 


IEWLMSCN 




| 324 


IEWLMSCN 




| 332 


IEWLMSCN 




| 342 


IEWLMINC 




| 354 


IEWLMRAT 




| 364 


IEWLMRAT 




J 374 


IEWLMRAT 




| 383 


IEWLMRAT 




| 394 


IEWLMFNL 




| 404 


IEWLMFNL 




| 414 


IEWLMFNL 




| 421 


IEWLMFNL 




| 432 


IEWLMINC 




| 444 


IEWLMSCD 




| 461 


IEWLMADA 




| 473 


IEWLMENT 




| 484 


IEWLMINP 




| 492 


IEWLMSCN 




| 504 


IEWLMFNL 




| 512 


IEWLMINC 




| 522 


IEWLMINC 




| 532 


IEWLMINC 




| 543 


IEWLMFNL 




| 594 


IEWLMINT, IEWLMINP 




| 611 


IEWLMRAT 




| 630 


IEWLMMAP 




| 611 

L I 


IEWLMRAT 


-. J 
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SECTION 7: APPENDIX 



This section contains linkage editor 
input conventions and record formats. The 
I/O conventions and record formats for 
Linkage Editor E and Linkage Editor F are 
the same.) 



INPUT CONVENTIONS 

Input modules (object or load) to be 
processed in a single execution of linkage 
editor must conform with a number of input 
conventions. Violations of the following 
are treated as errors by linkage editor: 

• All text records of a control section 
must follow the ESD record containing 
the SD or PC entry that describes the 
control section. 



• No LD or LR may have the same name as 
an SD or CM. 

• All SYM records must be placed at the 
beginning of an input module. The ESD 
for an input module containing test 
translator statements must follow the 
SYM records and precede the TXT 
records. 

• Linkage editor accepts TXT records that 
are out of order within a control sec- 
tion , even though linkage editor pro- 
cessing may be affected. TXT records 
are accepted even though they may over- 
write previous text in the same control 
section. Linkage editor does not eli- 
minate any RLD records that correspond 
to overwritten text. 



• The end of every input module must be 
marked by an end record (END in object 
modules, LAST in load modules) . 

• Each input module may contain only one 
no-length control section (a control 
section whose length field in its SD- 
or PC- type ESD entry contains zeros) . 
The length must be specified on the END 
record of any module that contains a 
no-length control section. 

• After processing the first text record 
of a no-length control section, linkage 
editor will not accept a text record of 
a different control section within the 
same input module. 

• Any RLD item must be read after the ESD 
item to which it refers; if it refers 
to a label within a different control 
section, it must be read after the ESD 
item for that control section. 

• The language translators must gather 
RLD items in groups of identical posi- 
tion pointers. No two RLD items having 
the same P pointer can be separated by 
an RLD item having a different P 
pointer. 

• Each record of text 1 and each LD- or 
LR-type ESD record must refer to an SD 
or PC entry in the ESD. 

• The position pointer of every RLD reco- 
rd must point to an SD- or PC-type 
entry in the ESD. 



1 A common (CM) control section cannot con- 
tain text or external references. 



• During a single execution of linkage 
editor, if two or more control sections 
having the same name are read in, only 
the first control section is accepted; 
the subsequent control sections are 
deleted. 

• Linkage editor interpretes common (CM) 
ESD items (blank or with the same name) 
as references to a single control sec- 
tion, whose length is the maximum 
length specified in the CM items of 
that name (or blank) . No text may be 
contained in a common control section. 

• Within an input module, linkage editor 
does not accept an SD- or PC-type ESD 
item after the first RLD item is read. 

To avoid unnecessary scanning and I/O 
operations, input modules should conform 
with the following conventions. Although 
violations of these rules are not treated 
as errors, avoiding them will improve the 
efficiency of linkage editor processing. 

• Within an input module, no LD or SD may 
have the same name as an ER. 

• Within an input module, no two ERs may 
have the same name. 

• Within an input module, TXT records may 
be in the order of the addresses 
assigned by the language translator. 

(If TXT records are not in address 
sequence, each reorigin operation may 
require additional linkage editor pro- 
cessing time.) 

• SYSUT1 record size should be at least 
as large as SYSLMOD. 
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RECORD FORMATS 

The following are the card image and load module record formats for the level F ver- 
sion of the linkage editor. 



SYM Input Record (Card Image) 



2-4 



5-10 



11,12 



13-72 



73-80 



TESTRAN data 



Number of bytes of TESTRAN data 



- Blank 
- SYM 
12-9-2 (0000 0010)/ 



Not used 



Figure 64. SYM Input Record (Card Image) 



ESP Input Record (Card Image) 



1 2-4 



5-10 



11,1213,1415,16 



17-72 



73-80 



r 



ESP Data — see below 

Blank if all ESP items are LP 

ESP IDENTIFIER of first ESP item (other than LP) 

Blank 
Number of bytes of ESP data 



r 



Not used 



1 Blank 

- ESP 

12-9-2 (0000 0010) 
ESP Pata Item 



1-8 



10-12 



13 



14-16 



Zero - if length is on ENP card. 

Length of control section (if type is: SP, PC, CM) 
" Identifier of SP entry containing name 
" Blank if type is ER 
Length of pseudo-register (PR) 



Blank - Alignment Factor for type PR 

1 — 24 bit address (SP, PC, LP, LR) 

Type - Hex (00=SP,01=LP,02=ER,03=LR,04=PC,05=CM,06=PR) 



Name — when type is: SP,LP,LR,ER,CM,PR 
1 — Blank — when type is: PC or blank CM. 



Figure 65. ESD Input Record (Card Image) 
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Text Input Record (Card Image) 



1 2-4 5 6-8 9-10 11,1213,1415,16 17-72 



C 



73-80 



u 



Text data (machine language code) 
- ESP Identifier of SD for control section of this text 
Blank 
Number of bytes of text data 
Blank 
■24 bit address of first byte of text data 

1 Blank 

— TXT 
12-9-2 (0000 0010) 

Figure 66. Text Input Record (Card Image) 



Not used 



RLD Input Record (Card Image) 



1 


2-4 


5-10 1 


1-12 


13-16 


17-72 


73-80 










1 RLD data - see below 


' Not used 










1 Blank 










Number of bytes of RLD data 








— Blank 






1 RLD 






— 12-9- 


2 (0000 0010) 











1,2 



3,4 



6,7,8 



r 



RLD data item 



Assigned address of address constant 



1 Flag_ field — (TTTTLLSTn) 

TTTT=type 

0000=non-branch 

0001=branch 

0011=pseudo register cumulative length 

LL=length of address constant 

01=2 bytes 
• 1 0=3 bytes 

1 1=4 bytes 



S=Direction of relocation 
0=positive (+) 
l=negative (-) 
Tn=type of next RLD item 
0=next RLD item has a different R or P 

pointer; they are present in the next item. 
l=next RLD item has the same R and P point- 
ers, hence they are omitted. 



' Position pointer (P) - ESDID of SD for control section that contains the address constant 

Relocation pointer (R) - ESDID of CESD entry for the symbol being referred to. Zero (00) if type=PR cumultative length 

Figure 67. RLD Input Record (Card Image) 
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END Input Record - Type 1 (Card Image) 



1 2-4 5 6-8 9-14 15,16 



17-28 



29-32 



33-80 



r 



Not used 



" Control section length for control section whose length was not specified 
in SD ESD item. Byte 29 is binary zero if length is present. 
1 Blank 

ESDID of SD item for this control section that contains the address specified in bytes 6-8. 

Blank 

24 bit address of entry point (optional) 

- Blank 

END 

" 12-9-2 (0000 0010) 

Figure 68. END Input Record - Type 1 (Card Image) 



END Input Record - Type 2 (Card Image) 



1 2-4 



5-16 



17-24 



25-28 29-32 



33-80 



• Not used 

Control section length for control section whose length was not specified 

in SD ESD item 



" Blank 
Symbolic entry point name (optional) 
" Blank 
— END 
-12-9-2 (0000 0010) 

Figure 69. END Input Record - Type 2 (Card Image) 

SYM Record - (Load Module) 



2,3 



4-243 



3£ 



• SYM data and ESD data (ESD type SD, CM and PC items) - (maximum of 240 

bytes) 
1 Count - in bytes, of SYM and ESD data (2 bytes) 

Subtype - specifies information for TESTRAN - (1 byte) 

1000 0000 - this SYM record contains ESD items (SD, PC or CM) from 
a load module that was not "under test". The test 
option was not specified when it was link edited. 
0000 0000 - this SYM record is not the above type. 



- Identification - specifies this is a SYM record — 0100 0000 (1 byte) 

Figure 70. SYM Record - (Load Module) 
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CESD Record - (Load Module) 



1-3 



4,5 



6,7 



8-247 



1<L 



up to 240 bytes of ESD data 



ESD data - for detailed information see below. 

Count - in bytes, of ESD data (2 bytes) 

ESDID of first ESD item (2 bytes) 
Spare - 3 bytes of binary zeros 
' Identification — 0010 0000 — (1 byte) 



CESD Data (Load Module) 



1-8 



10-12 



13 



14-16 



c 



ID/length - length (3 bytes), when type is: SD, PC, CM or PR 
ID (2 bytes), when type is LR 
Zero (3 bytes), when type is ER or Null 



'Segment number - in which this symbol appears. Zero when type is ER or Null (1 byte). 
Address - linkage editor assigned address of this symbol. Zero when type is ER or Null (3 bytes). 

Type - (1 byte) Section definition (SD) - hex 00 

Label reference (LR) - hex 03 

Private code (PC) - hex 04 
Private code marked delete 

(ENTAB and SEGTAB control sections) _ hex 14 

Common (CM) _ hex 05 

Nul1 - hex 07 

External reference (ER) _ hex 02 

Pseudo register (PR) _ hex 06 



- Symbol - The eight character external name - Zero when type is Null. 

Figure 71. CESD Record - (Load Module) 
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Scatter - Translation Record 



2-3 



4-1023 



x 



Up to and including 1020 bytes 



~ Data - may contain translation table, translation table and scatter table or scatter table only 

1 Count - in bytes, of data field 

1 Zero - one byte of binary zeros 

" Identification - identifies this as a scatter-translation record - bit configur- 
ation is: 0001 0000 



Translation Table 



C 



JL 



Padding (2 bytes) - if necessary, to force full-word boundary alignment of scatter table. 

- Pointer (2 bytes) - to the scatter table entry that contains the address of the 
control section containing this CESD entry. 

Number of translation table entries = number of CESD entries +1 . 
Pointer will be zero if its corresponding CESD entry is not 
SD, PC, CM or LR. 



' Zero - 2 bytes of binary zeros 



Scatter Table 



C 



X 



- Assigned address (4 bytes) - of a control section (SD, PC or CM) 
- Zero - 4 bytes of binary zeros 



Translation 


Tabl 


e and Scatter Table 


























Tl 


T 2 


T 3 


T 


T 


% 


T 


T n 


P 


Si 


s 2 


h 


S 












Sn 


















' 


' Scatt 

Padding (2 


er data 
bytes) if n 


ecessary tc 


> align sea 


tter t 


able to a f 


ull-word b 


oundary. 







-Translation data 



Figure 72. Scatter-Translation Record 
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Control Record - (Load Module) 



1-3 



4-5 



6-7 



8-15 



3S 



Record Length 20 to 256 bytes for level F 



- Length of text record ond/or length of control section - specifies the 

length of the control section (in bytes) to which the text in the 
following record belongs, or the number of bytes of a control 
section contained in the following text record (2 bytes) 

* CESD entry number - specifies the composite external symbol dictionary entry that 

contains the control section name of the control section of which this text is a part (2 bytes) 



Channel Command Word (CON) - that could be used to read the text record that follows. The data address field contains 

the linkage editor assigned address of the first byte of text in the text record that follows The count field contains the 
length of the succeeding text record. 

Count - contains two bytes of binary zeros. 

Count - in bytes, of the control information (CESD ID, length of control section) following the CCW field. 

Spare - contains three bytes of binary zeros 

Identification - specifies that this is: (1 byte) 

• A control record - 0000 0001 

• The control record that precedes the last text record of this overlay segment - 0000 0101 (EOS) 

• The control record that precedes the last text record of the module - 0000 1101 (EOM) 

Figure 73. Control Record - (Load Module) 
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Relocation Dictionally Record - (Load Module) 



X 



1-3 4,5 6,7 



8-15 



16-255 



Record length can be between 24 and 256 



' — RLD data — see below 
■ Spare - contains 8 bytes of binary zeros 

' Count - in bytes of the relocation dictionary information following the spare 8 byte field (2 bytes) 

Count - contains two bytes of binary zeros 
1 Spare - contains three bytes of binary zeros 

' Identification - specifies that this is: (1 byte) 

• A relocation dictionary record - 0000 0010 

• The last record of the segment - 0000 0110 

• The last record of the module - 0000 1110 



RLD Data 



£ 



r 



Address ■ 



linkage editor assigned address of 
the address constant (3 bytes) 



Flag 



1 Position pointer ■ 



Relocation pointer 



(1 byte) When byte format is xxxxLLST, 

specifies miscellaneous information as follows: 

xxxx specifies the type of this RLD item (address constant). 

0000 — non-branch type in assembler language, DC A (name) 

0001 — branch type (in assembler language, DC V (name) 

0010 — pseudo register displacement value 

001 1 — pseudo register cumulative displacement value 

1000 and 1001 — this address constant is not to be relocated because it refers to an unresolved symbol. 
LL specifies the length of the address constant. 
01 — two byte 

1 — three byte 

1 1 — four byte 
S specifies the direction of relocation. 

— positive 

1 — negative 
T specifies the type of the next following RLD item. 

— the following RLD item has a different relocation and/or position pointer. 

1 — the following RLD item has the same relocation and 
position pointers as this and therefore is omitted. 

contains the entry number of the CESD entry (or translation table entry) 
that indicates which control section holds the address constant (2 bytes). 

contains the entry number of the CESD entry (or translation table entry) that indicates which symbol value 
is to be used in the computation of the address constant's value (2 bytes). 



Figure 74. Relocation Dictionary Record - (Load Module) 
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Control and Relocation Dictionary Record - (Load Module) 



1 -3 



4,5 



6,7 



8-15 



X 



' — * Length of control section 
or text record (2 bytes) 
' CESD entry number (2 bytes) 



- Address 

1 — Flag 

- Address (3 bytes) 

1 Flag (1 byte) 

1 Position pointer (2 bytes) 

Relocation pointer (2 bytes) 

1 — Channel Command Word (8 bytes) 

1 Count , in bytes, of RLD information (2 bytes) 

-Count, in bytes, of control information following the last RLD address field. 
The control information contains the ID and length of control sections in the 
following text record (2 bytes). 



" Spare (3 bytes) 
" Identification (1 byte) 



specifies that this record is: 

• A control and RLD record - 0000001 1 - (it is followed by a text record) 

• A control and RLD record that is followed by the last text record of a segment - 0000 01 1 1 (EOS) 

• A control and RLD record that is followed by the last text record of a module - 0000 1111 (EOM) 



Note : For detailed descriptions of the data fields see Relocation Dictionary Record, and Control Record. 
The record length varies from 20 to 260 bytes in the level E linkage editor 

Figure 75. Control and Relocation Dictionary Record - (Load Module) 
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